Endpoint Playground
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.
14 Oct 2026: 40 stores; 18 fields had a value in every checked item and 2 varied between items.
Sample value profiles: region: Madrid (39), Pozuelo (1); name: “Vallejo Nájera” and 39 other values; map_url: maps.google.com.
curl 'https://api.crawlora.net/api/v1/papajohns/intl/stores?market=spain&fulfillment=delivery' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| market | string | Yes | spain | Market. One of: chile, costa-rica, guatemala, panama, portugal, spain |
| store_id | string | No | Look up one known restaurant by id instead of searching a coordinate. Supply either store_id, or both latitude and longitude. | |
| latitude | string | No | Latitude to search around. Required unless store_id is supplied. | |
| longitude | string | No | Longitude to search around. Required unless store_id is supplied. | |
| fulfillment | string | No | delivery | One of: delivery (default, every nearby restaurant), pickup (only restaurants accepting pickup orders). Ignored when store_id is supplied. |
| page | integer | No | One-based page of the distance-ranked restaurants. Ignored for a store_id lookup and for pickup, neither of which is paginated. | |
| limit | integer | No | Restaurants per page, 1-100. Ignored for a store_id lookup and for pickup, neither of which is paginated. |
{
"code": 200,
"msg": "OK",
"data": {
"market": "spain",
"fulfillment": "delivery",
"latitude": 40.4168,
"longitude": -3.7038,
"stores": [
{
"id": 9,
"name": "Vallejo Nájera",
"menu_id": 8,
"address": "Paseo de Juan Antonio Vallejo - Nájera Botas, 25, 28005",
"city": "Madrid",
"region": "Madrid",
"phone": "+34910493017",
"latitude": 40.401686,
"longitude": -3.708348,
"order_method": "both",
"delivery_open": true,
"pickup_open": true,
"delivery_wait_minutes": 30,
"pickup_wait_minutes": 15,
"future_orders": true,
"external_delivery": true,
"payment_methods": [
"apple_pay",
"bizum",
"cash",
"credit",
"direct_click_to_pay",
"google_pay",
"paypal"
],
"delivery_zones": [
{
"name": "La más fresca 6,99€",
"delivery_price": 0
}
],
"hours": [
{
"day": "monday",
"dispatch_method": "in_store",
"opens": "12:00:00",
"closes": "23:59:59"
}
]
}
],
"count": 5,
"page": 1,
"total_pages": 20,
"total_count": 97,
"source_url": "https://api.papajohns.es/v1/stores?latitude=40.4168&longitude=-3.7038",
"fetched_at": "2026-09-06T09:00:00Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.