Docs menu

Papa John's API endpoint

Papa John's Directory API

Returns 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.

GETapiKey1 credit/requestPapa John'spapajohns.directoryResponseDoc/papajohns/directory

Endpoint facts

Method: GET
API path: /papajohns/directory
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Papa John's
Response schema: #/definitions/papajohns.directoryResponseDoc

Papa John's API Try Papa John's Directory API in Playground Papa John's API documentation

How this endpoint behaves

Query parameters:

path (optional) — a directory path from children[].path, such as united-states/ca. Omit it for the root index.

Each child includes name, path, url, is_store, and store_count when published. Pass a child with is_store: true to /papajohns/store. Use /papajohns/nearby for coordinate search.

Live monitoring

Monitored request: GET /papajohns/directory
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.83 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /papajohns/directory
Items in children: 2
Fields filled in every checked item: 5

Field	Filled in, of 2 checked	Values in the sample
name	2	“CA” and 1 other value
path	2	“ca” and 1 other value
url	2	locations.papajohns.com
store_count	2	223 to 3,080, median 223
is_store	2	true in 0 of 2

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	No		Directory path from a previous response's children[].path; omit for the root country index	united-states/ca
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/papajohns/directory" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "path": "",
    "name": "",
    "children": [
      {
        "name": "United States",
        "path": "united-states",
        "url": "https://locations.papajohns.com/united-states",
        "store_count": 3500,
        "is_store": false
      }
    ],
    "count": 1,
    "source_url": "https://locations.papajohns.com/index.html",
    "fetched_at": "2026-09-04T09:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/papajohns.directoryResponseDoc

Field	Type	Required	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.DirectoryResponse	No
data.children	array	No
data.children[].is_store	boolean	No	false	IsStore marks a child that is a store page rather than another directory level -- call /papajohns/store with its path.
data.children[].name	string	No	CA
data.children[].path	string	No	united-states/ca
data.children[].store_count	integer	No	222	StoreCount is how many stores sit under this branch, as Yext reports it. Absent once children are stores themselves.
data.children[].url	string	No
data.count	integer	No	120
data.fetched_at	string	No
data.name	string	No
data.path	string	No	united-states/ca
data.source_url	string	No
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/papajohns/directory" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Papa John's endpoint docs Papa John's API Papa John's Allergens API documentation Papa John's Colombia Menu API documentation Papa John's Deals API documentation Papa John's El Salvador Menu API documentation Papa John's India Deal API documentation Papa John's India Menu API documentation

Open in Playground Back to group

Docs menu

Papa John's API endpoint

Papa John's Directory API

GETapiKey1 credit/requestPapa John'spapajohns.directoryResponseDoc/papajohns/directory

Endpoint facts

Method: GET
API path: /papajohns/directory
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Papa John's
Response schema: #/definitions/papajohns.directoryResponseDoc

Papa John's API Try Papa John's Directory API in Playground Papa John's API documentation

How this endpoint behaves

Query parameters:

path (optional) — a directory path from children[].path, such as united-states/ca. Omit it for the root index.

Each child includes name, path, url, is_store, and store_count when published. Pass a child with is_store: true to /papajohns/store. Use /papajohns/nearby for coordinate search.

Live monitoring

Monitored request: GET /papajohns/directory
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.83 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /papajohns/directory
Items in children: 2
Fields filled in every checked item: 5

Field	Filled in, of 2 checked	Values in the sample
name	2	“CA” and 1 other value
path	2	“ca” and 1 other value
url	2	locations.papajohns.com
store_count	2	223 to 3,080, median 223
is_store	2	true in 0 of 2

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	No		Directory path from a previous response's children[].path; omit for the root country index	united-states/ca
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/papajohns/directory" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "path": "",
    "name": "",
    "children": [
      {
        "name": "United States",
        "path": "united-states",
        "url": "https://locations.papajohns.com/united-states",
        "store_count": 3500,
        "is_store": false
      }
    ],
    "count": 1,
    "source_url": "https://locations.papajohns.com/index.html",
    "fetched_at": "2026-09-04T09:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/papajohns.directoryResponseDoc

Field	Type	Required	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.DirectoryResponse	No
data.children	array	No
data.children[].is_store	boolean	No	false	IsStore marks a child that is a store page rather than another directory level -- call /papajohns/store with its path.
data.children[].name	string	No	CA
data.children[].path	string	No	united-states/ca
data.children[].store_count	integer	No	222	StoreCount is how many stores sit under this branch, as Yext reports it. Absent once children are stores themselves.
data.children[].url	string	No
data.count	integer	No	120
data.fetched_at	string	No
data.name	string	No
data.path	string	No	united-states/ca
data.source_url	string	No
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/papajohns/directory" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Papa John's Directory API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Papa John's Directory API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related