Papa John's

Get one Papa John's offer's composition (international)

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.

get/papajohns/intl/offer

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/papajohns/intl/offer
  • 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

offer_idstring required

Offer id from the offer_id field on GET /papajohns/intl/deals

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": {
    "currency": "EUR",
    "customizable": true,
    "dispatch_method": "both",
    "end_date": "2026-09-21T23:45:00Z",
    "free_extras": 2,
    "id": 660,
    "market": "spain",
    "max_ingredients": 10,
    "min_ingredients": 1,
    "name": "Combo Veranito",
    "offer_type": "Combo",
    "price": 19.98,
    "promoted": true,
    "start_date": "2023-09-19T01:00:00Z",
    "steps": [
      {
        "choice_count": 12,
        "choices": [
          {
            "crust": "traditional",
            "crust_label": "Original",
            "name": "Italiana Ranch",
            "product_id": 336,
            "size": "family",
            "size_label": "Familiar",
            "surcharge": 1.9,
            "variant_id": 830
          }
        ],
        "id": 1919,
        "name": "❶  Elige tu pizza familiar"
      }
    ]
  }
}

Changes

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