Endpoint Playground
Returns one promotional offer's full composition in one of six international markets: Chile, Costa Rica, Guatemala, Panama, Portugal, and Spain. This is what a promotion banner from GET /papajohns/intl/deals actually contains: the offer's own price, each choice step a customer works through in order (e.g. "pick your family pizza", "pick a side"), and every product eligible at that step with the surcharge picking it adds. It also carries the offer's ingredient rules -- how many extras are free, the minimum and maximum that may be chosen, and which ingredient families are allowed. Offer ids come from the offer_id field on a deal.
14 Oct 2026: Single record response; 19 fields had a value in every checked item.
Sample value profiles: start_date: 2023-09-19; price: 19.98; market: “spain”.
curl 'https://api.crawlora.net/api/v1/papajohns/intl/offer?market=spain&offer_id=660' \
-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 |
| offer_id | string | Yes | 660 | Offer id from the offer_id field on GET /papajohns/intl/deals |
{
"code": 200,
"msg": "OK",
"data": {
"market": "spain",
"id": 660,
"name": "Combo Veranito",
"description": "1 Familiar + Entrante + 2 Cocktails.",
"offer_type": "Combo",
"dispatch_method": "both",
"price": 19.98,
"currency": "EUR",
"start_date": "2023-09-19T01:00:00Z",
"end_date": "2026-09-21T23:45:00Z",
"availability": [
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday",
"sunday"
],
"customizable": true,
"promoted": true,
"free_extras": 2,
"min_ingredients": 1,
"max_ingredients": 10,
"ingredient_categories": [
"extra_cheese",
"meat",
"premium",
"shots",
"vegetable"
],
"steps": [
{
"id": 1919,
"name": "❶ Elige tu pizza familiar",
"optional": false,
"choices": [
{
"product_id": 336,
"variant_id": 830,
"name": "Italiana Ranch",
"size": "family",
"crust": "traditional",
"size_label": "Familiar",
"crust_label": "Original",
"surcharge": 1.9
}
],
"choice_count": 12
}
],
"source_url": "https://api.papajohns.es/v1/offers/660",
"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.