Papa John's

Find Papa John's restaurants in an international market

Returns Papa John's restaurants in one of six international markets: Chile, Costa Rica, Guatemala, Panama, Portugal, and Spain -- either every restaurant near a coordinate, or one known restaurant looked up by id. Each restaurant carries its address, coordinates, phone, per-weekday opening hours split by fulfillment channel, accepted payment methods, delivery zones with their minimum-order and free-delivery thresholds, and live delivery/pickup open flags. Restaurants come back ranked by distance with no radius limit, five at a time by default; page and limit walk the rest, and the response reports total_count, the market's whole restaurant total. The returned id is what GET /papajohns/intl/menu prices against, and menu_id is what GET /papajohns/intl/ingredients reads. This covers those six markets only -- for India use GET /papajohns/india/stores, and for the US and Canada use GET /papajohns/directory, GET /papajohns/store, or GET /papajohns/nearby.

get/papajohns/intl/stores

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/papajohns/intl/stores
  • Auth: API key in header x-api-key

Query parameters

market'chile' | 'costa-rica' | 'guatemala' | 'panama' | 'portugal' | 'spain' required

Market. One of: chile, costa-rica, guatemala, panama, portugal, spain

store_idstring

Look up one known restaurant by id instead of searching a coordinate. Supply either store_id, or both latitude and longitude.

latitudestring

Latitude to search around. Required unless store_id is supplied.

longitudestring

Longitude to search around. Required unless store_id is supplied.

fulfillment'delivery' | 'pickup'

One of: delivery (default, every nearby restaurant), pickup (only restaurants accepting pickup orders). Ignored when store_id is supplied.

pageinteger

One-based page of the distance-ranked restaurants. Ignored for a store_id lookup and for pickup, neither of which is paginated.

limitinteger

Restaurants per page, 1-100. Ignored for a store_id lookup and for pickup, neither of which is paginated.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 5,
    "fulfillment": "delivery",
    "latitude": 40.4168,
    "longitude": -3.7038,
    "market": "spain",
    "page": 1,
    "stores": [
      {
        "city": "Madrid",
        "delivery_open": true,
        "delivery_wait_minutes": 30,
        "delivery_zones": [
          {
            "name": "Zona 1"
          }
        ],
        "external_delivery": true,
        "future_orders": true,
        "hours": [
          {
            "closes": "23:59:59",
            "day": "monday",
            "dispatch_method": "in_store",
            "opens": "12:00:00"
          }
        ],
        "id": 9,
        "latitude": 40.401686,
        "longitude": -3.708348,
        "menu_id": 8,
        "name": "Vallejo Nájera",
        "order_method": "both",
        "phone": "+34910493017",
        "pickup_open": true,
        "pickup_wait_minutes": 15,
        "region": "Madrid"
      }
    ],
    "total_count": 97,
    "total_pages": 20
  }
}

Changes

No recorded changes to this operation across all 3 revisions of this API.