Papa John's API endpoint
Returns one Papa John's restaurant's full menu with that restaurant's own prices, in one of six international markets: Chile, Costa Rica, Guatemala, Panama, Portugal, and Spain. Prices are per restaurant, not national, so two restaurants in the same market can differ. Each pizza lists every size and crust combination it is sold in with that combination's own price and, where published, its calorie and portion figures; sides, drinks and desserts list their own portions. Machine codes for size and crust are returned alongside the market's own display labels in the local language. Currency is whatever the market trades in -- euros in Spain and Portugal, Chilean pesos in Chile, and so on -- so do not compare figures across markets. Use GET /papajohns/intl/stores to find a store_id. For India use GET /papajohns/india/menu; for the US and Canada see GET /papajohns/nutrition.
/papajohns/intl/menuPrices are per restaurant and per market. Two restaurants in the same market can price the same pizza differently, and currency differs by market (euros in Spain and Portugal, Chilean pesos in Chile, and so on) — do not compare figures across markets. For India use
/papajohns/india/menu; for US national reference data see/papajohns/nutrition.
Query parameters:
market (required) — one of chile, costa-rica, guatemala, panama, portugal, spain.store_id (required) — a restaurant id from
/papajohns/intl/stores.kind (optional) — return only one product kind. One of pizza or
side.food_type (optional) — return only products carrying this dietary or heat
marker. One of hot, mild, spicy, vegetarian.Notable response behavior:
variants lists every size and crust combination it is sold
in, each with its own price and, where the market publishes it, calorie and
portion figures. Sides and drinks list their own portions the same way.size and crust are stable machine codes; size_label and
crust_label are the market's own display names in the local language.
The response's sizes and crusts maps carry every code it used.price_from on each product is
the cheapest variant's price.food_type filters on a marker only a minority of products carry, so it
deliberately returns a narrow subset — products upstream has not marked are
excluded rather than assumed to qualify. Matching is case-insensitive.nutrition is present only where the market publishes real figures; an
all-zero upstream panel is omitted rather than reported as zero calories.store_id returns a 404; an unknown market or kind
returns a 400.| Field | Filled in, of 28 checked | Values in the sample |
|---|---|---|
| id | 28 | |
| name | 28 | “BBQ Veggie” and 27 other values |
| kind | 28 | pizza in all 28 |
| category | 28 | pizza (26), byop (1), by_halves (1) |
| description | 28 | median 125 characters |
| food_type | 12 | median 1 entry |
| customizable | 26 | true in 26 of 26 |
| image_url | 28 | cdn.new.papajohns.es |
| variants | 28 | median 8 entries |
| price_from | 28 | 0 to 16.99, median 15.99 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| market | string | Yes | Market. One of: chile, costa-rica, guatemala, panama, portugal, spain Allowed values: chile, costa-rica, guatemala, panama, portugal, spain. | spain | |
| store_id | string | Yes | Restaurant id from GET /papajohns/intl/stores. Prices are specific to this restaurant. | 9 | |
| kind | string | No | Return only one product kind. One of: pizza, side Allowed values: pizza, side. | pizza | |
| food_type | string | No | Return only products carrying this dietary or heat marker. One of: hot, mild, spicy, vegetarian. Products upstream does not mark are excluded. Allowed values: hot, mild, spicy, vegetarian. | vegetarian | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/papajohns/intl/menu?market=spain&store_id=9&kind=pizza&food_type=hot" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"market": "spain",
"store_id": 9,
"currency": "EUR",
"products": [
{
"id": 8,
"name": "Super Papa",
"kind": "pizza",
"category": "pizza",
"description": "Salsa de tomate natural, carne de cerdo especiada, pepperoni crujiente…",
"customizable": true,
"image_url": "https://cdn.new.papajohns.es/pictures/pizzas/superpapa750x600.webp",
"variants": [
{
"size": "medium",
"crust": "traditional",
"size_label": "Mediana",
"crust_label": "Original",
"price": 14.99,
"currency": "EUR"
},
{
"size": "family",
"crust": "traditional",
"size_label": "Familiar",
"crust_label": "Original",
"price": 19.98,
"currency": "EUR"
}
],
"price_from": 14.99
}
],
"count": 43,
"sizes": {
"family": "Familiar",
"medium": "Mediana"
},
"crusts": {
"traditional": "Original"
},
"source_url": "https://api.papajohns.es/v1/prices?store_id=9",
"fetched_at": "2026-09-06T09:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/papajohns.intlMenuResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | papajohns.IntlMenuResponse | No | ||||
| data.count | integer | No | 43 | |||
| data.crusts | object | No | ||||
| data.currency | string | No | EUR | |||
| data.fetched_at | string | No | ||||
| data.food_type | string | No | vegetarian | |||
| data.kind | string | No | pizza | |||
| data.market | string | No | spain | |||
| data.products | array | No | ||||
| data.products[].alcohol | boolean | No | ||||
| data.products[].category | string | No | pizza | |||
| data.products[].currency | string | No | EUR | |||
| data.products[].customizable | boolean | No | ||||
| data.products[].description | string | No | ||||
| data.products[].discount | number | No | ||||
| data.products[].food_type | array | No | FoodType carries dietary markers the platform publishes, e.g. vegetarian. | |||
| data.products[].id | integer | No | 8 | |||
| data.products[].image_url | string | No | ||||
| data.products[].initial_price | number | No | ||||
| data.products[].kind | string | No | pizza | Kind is "pizza" or "side" -- the platform's two product families. | ||
| data.products[].name | string | No | Super Papa | |||
| data.products[].price | number | No | Price is set only for a product the platform prices directly rather than through variants. Read variants for anything with sizes or crusts. | |||
| data.products[].price_from | number | No | 14.99 | PriceFrom is the cheapest variant price, so a caller can rank products without walking every variant. Absent when the product has no priced variant and no direct price. | ||
| data.products[].variants | array | No | ||||
| data.products[].variants[].crust | string | No | traditional | |||
| data.products[].variants[].crust_label | string | No | Original | |||
| data.products[].variants[].currency | string | No | EUR | |||
| data.products[].variants[].discount | number | No | ||||
| data.products[].variants[].initial_price | number | No | InitialPrice is the pre-discount price when a promotion is active. | |||
| data.products[].variants[].name | string | No | 500ML | Name is the variant's own label where the platform gives it one, e.g. a drink's "500ML". Pizza variants are identified by size and crust instead. | ||
| data.products[].variants[].nutrition | papajohns.IntlNutrition | No | ||||
| data.products[].variants[].nutrition.calories | number | No | 1090 | |||
| data.products[].variants[].nutrition.grams | number | No | 470 | |||
| data.products[].variants[].nutrition.portions | string | No | 8 | |||
| data.products[].variants[].price | number | No | 19.98 | |||
| data.products[].variants[].size | string | No | family | Size and Crust are the platform's stable machine codes. | ||
| data.products[].variants[].size_label | string | No | Familiar | SizeLabel and CrustLabel are the market's own display names for those codes, in the local language. | ||
| data.sizes | object | No | Sizes and Crusts map every machine code used in this response to the market's own display label. | |||
| data.source_url | string | No | ||||
| data.store_id | integer | No | 9 | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/papajohns/intl/menu?market=spain&store_id=9&kind=pizza&food_type=hot" \
-H "x-api-key: $CRAWLORA_API_KEY"