Papa John's International Menu API

Endpoint facts

Method

GET

API path

/papajohns/intl/menu

Auth

apiKey

Credits

1 credit/request

Platform

Papa John's

Response schema

#/definitions/papajohns.intlMenuResponseDoc

Overview

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. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

1 credit/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

• Proxy strategy: managed automatically where needed
• Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
• Browser cluster: supported dynamic workloads can be routed through distributed browser instances
• Retry behavior: automatic retry/fallback may be used depending on endpoint type
• Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Response behavior

- Each pizza's `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. - Variants are ordered cheapest first, and `price_from` on each product is the cheapest variant's price. - A product with no direct price and no priced variant is omitted rather than returned looking free, as are products upstream has hidden. - `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. - Size and crust labels come from a second upstream call. If that call fails the menu still returns, with machine codes and no labels. - An unknown `store_id` returns a `404`; an unknown `market` or `kind` returns a `400`. Example response: ```json {"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"}} ```

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Related