JimmyJohns API endpoint
Returns one page of Jimmy John's sitemap-declared store index -- 9,700+ URLs at time of writing. Jimmy John's publishes three page variants per store (sandwiches, delivery, catering) and all three appear in the sitemap, so each entry carries a kind and the store number they share; filter with the kind parameter to enumerate one variant per restaurant. `sandwiches` is the canonical variant. A page past the end returns an empty list rather than an error, so a caller can walk to exhaustion.
/jimmy-johns/sitemapQuery parameters:
shard (optional, default 0) — sitemap shard index.page (optional, default 1) — 1-based page within the shard.page_size (optional, default 100, max 500) — entries per page.kind (optional) — filter by page variant. One of sandwiches, delivery, catering. Default all.Response includes shard, shard_count, entries[], count, total_in_shard, page, total_pages, source_url, and fetched_at. Each entry has url, path, kind, and store_number.
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| url | 40 | locations.jimmyjohns.com |
| path | 40 | “in/columbus/sandwiches-1414.html” and 39 other values |
| kind | 40 | sandwiches in all 40 |
| store_number | 40 | 150 to 9,016, median 1,692 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| shard | integer | No | Sitemap shard index (default 0) | 0 | |
| page | integer | No | 1-based page within the shard (default 1) | 1 | |
| page_size | integer | No | Entries per page, 1-500 (default 100) | 100 | |
| kind | string | No | Filter by page variant. One of sandwiches, delivery, catering. Default all. Allowed values: sandwiches, delivery, catering. | sandwiches | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/sitemap?page=1&kind=sandwiches" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"shard": 0,
"shard_count": 1,
"entries": [
{
"url": "https://locations.jimmyjohns.com/in/columbus/sandwiches-1414.html",
"path": "in/columbus/sandwiches-1414.html",
"kind": "sandwiches",
"store_number": "1414"
}
],
"count": 1,
"total_in_shard": 2817,
"page": 1,
"total_pages": 29,
"source_url": "https://locations.jimmyjohns.com/sitemap1.xml",
"fetched_at": "2026-08-31T17:30:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/jimmyjohns.sitemapResponseDoc
| Field | Type | Required | Enum | Bounds | 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 | jimmyjohns.SitemapResponse | No | ||||
| data.count | integer | No | 100 | |||
| data.entries | array | No | ||||
| data.entries[].kind | string | No | sandwiches | Kind distinguishes the three page variants Jimmy John's publishes per store: sandwiches, delivery and catering. All three describe the same restaurant; `sandwiches` is the canonical one. | ||
| data.entries[].path | string | No | in/columbus/sandwiches-1414.html | |||
| data.entries[].store_number | string | No | 1414 | StoreNumber is the trailing id shared by all three variants. | ||
| data.entries[].url | string | No | ||||
| data.fetched_at | string | No | ||||
| data.page | integer | No | 1 | |||
| data.shard | integer | No | 0 | |||
| data.shard_count | integer | No | 1 | |||
| data.source_url | string | No | ||||
| data.total_in_shard | integer | No | 9789 | |||
| data.total_pages | integer | No | 98 | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| 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 |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/sitemap?page=1&kind=sandwiches" \
-H "x-api-key: $CRAWLORA_API_KEY"