API Reference
Use Crawlora's Papa John's API endpoints to extract supported public Papa John's data as structured JSON. This documentation covers 9 active endpoints including Get Papa John's full allergen guide, Browse the Papa John's store directory, Find Papa John's stores near a coordinate, Get one Papa John's nutritional-details category, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as latitude, longitude, category, path, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/papajohns/directory" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/papajohns/allergensapiKey1 credit/requestReturns Papa John's complete published item x allergen matrix (crusts, sauces, cheeses, meats, veggies, and more), grouped by section, each item flagged for peanut, tree nut, egg, milk, wheat, soy, fish, shellfish, and sesame content.
Required params: None
/papajohns/directoryapiKey1 credit/requestReturns one level of Papa John's store directory. Omit path for the root country index, then pass a child's path to descend through state, city, and store levels. Each child includes its name, path, URL, store count when available, and whether it is a store leaf. Pass a store child's path to GET /papajohns/store. This is a directory browse; use GET /papajohns/nearby for a coordinate search.
Required params: None
/papajohns/nearbyapiKey1 credit/requestReturns Papa John's stores within a radius of a latitude/longitude, ordered nearest first, with distance, address, phone, hours, timezone, price range, fulfillment services, payment options, and ordering link. The response includes total_in_radius and offset paging. A coordinate with no nearby stores returns an empty list.
Required params: latitude:query, longitude:query
/papajohns/nutritionapiKey1 credit/requestReturns Papa John's own published nutrition-facts panel for every item in one category -- full pizzas by name, or a single ingredient family (crust, cheese, sauce, toppings). Each item lists every published size/crust variant with serving size and a full nutrition-facts breakdown (calories, fat, cholesterol, sodium, carbohydrate, fiber, sugars, protein). This is Papa John's national reference data, not priced per-store data -- see GET /papajohns/directory for store lookup.
Required params: category:query
/papajohns/storeapiKey1 credit/requestReturns one Papa John's store's published profile: address, phone, coordinates, general and pickup hours, timezone, Google Place id, and ordering link. The path comes from a store child returned by GET /papajohns/directory. Passing a directory path returns 404.
Required params: path:query
/papajohns/india/dealapiKey1 credit/requestReturns one Papa John's **India** combo or offer with its full composition: each slot in the deal (with its quantity, size, and whether it can be skipped) and every menu item eligible to fill that slot, with each choice's own price in Indian Rupees. This is materially more than the deal row in GET /papajohns/india/menu, which carries only the deal's name, price, and pricing rule. price_type is one of fixedPrice, BuyXGetY, HalfAndHalf, or variablePrice; only fixedPrice deals report a non-zero price. India market only.
Required params: deal_id:query
/papajohns/india/menuapiKey1 credit/requestReturns Papa John's **India** menu with live prices in Indian Rupees, from papajohns.in's own ordering backend. This is the India market only -- prices, items, and availability are India-specific and are not comparable to Papa John's US/Canada data (see GET /papajohns/nutrition for US national reference data). Returns every category with its items and deals: list price, strike-through price where a discount is active, dietary tags (Veg, Non Veg, Spicy), images, and the store/channel/day combinations where an item is blacked out. Set include_options=true to also get each item's full size, crust, topping, sauce, and drizzle tree with per-option prices -- this makes the response very large, so prefer GET /papajohns/india/menu/item for one item's options. Pricing is franchise-wide rather than per-store; store_id, channel_id, and day filter item availability, not price, and only take effect when all three are supplied.
Required params: None
/papajohns/india/menu/itemapiKey1 credit/requestReturns one Papa John's **India** menu item with its complete customization tree: every size, and for each size every crust, topping, dipping sauce, drizzle, and base sauce with that option's own price in Indian Rupees. The option group flagged base_price carries the item's base price for that size (the crust group on pizzas) rather than an add-on charge; half_price is the surcharge when the option is applied to one half of a pizza. India market only -- prices are Indian Rupees. Use GET /papajohns/india/menu to discover item ids.
Required params: item_id:query
/papajohns/india/storesapiKey1 credit/requestReturns every Papa John's **India** restaurant with its address, phone, coordinates, and weekly opening hours broken down per order channel (delivery, take away, dine in, drive-through pickup). These store ids are what GET /papajohns/india/menu's store_id availability filter is keyed on. India market only -- for US/Canada stores use GET /papajohns/directory, GET /papajohns/store, or GET /papajohns/nearby.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Papa John's full allergen guide | /papajohns/allergens | GET | 1 credit/request | None | View docs | Try endpoint |
| Browse the Papa John's store directory | /papajohns/directory | GET | 1 credit/request | None | View docs | Try endpoint |
| Find Papa John's stores near a coordinate | /papajohns/nearby | GET | 1 credit/request | latitude:query, longitude:query | View docs | Try endpoint |
| Get one Papa John's nutritional-details category | /papajohns/nutrition | GET | 1 credit/request | category:query | View docs | Try endpoint |
| Get one Papa John's store | /papajohns/store | GET | 1 credit/request | path:query | View docs | Try endpoint |
| Get one Papa John's India deal's composition (INR) | /papajohns/india/deal | GET | 1 credit/request | deal_id:query | View docs | Try endpoint |
| Get the Papa John's India priced menu (INR) | /papajohns/india/menu | GET | 1 credit/request | None | View docs | Try endpoint |
| Get one Papa John's India item with its full options (INR) | /papajohns/india/menu/item | GET | 1 credit/request | item_id:query | View docs | Try endpoint |
| List Papa John's India restaurants | /papajohns/india/stores | GET | 1 credit/request | None | View docs | Try endpoint |