Shake Shack API endpoint
Returns one page of Shake Shack's store index, parsed off the single, fully server-rendered /locations page. That page carries two independent sections: an interactive map (coordinates, no structured address) and an accessible "Full List of Locations" text index (structured address, no coordinates). Each entry's source field says which section it came from -- "map" or "list" -- not a business classification; both round-trip through GET /shakeshack/store by path, which always returns full structured address and coordinates regardless of source.
/shakeshack/locationslist -- Shake Shack's own "Full List of Locations" text index. Carries a path in the aliased location/<slug> form. No coordinates.map -- the interactive map's pin data. Carries a path in the legacy node/<id> form. No structured address, only coordinates.This is a description of which page section published the entry, not a business classification -- both kinds round-trip through /api/v1/shakeshack/store by path, which always returns full structured address and coordinates regardless of source.
Query parameters:
page (optional, default 1) -- 1-based page.page_size (optional, default 100, max 500) -- entries per page.A page past the end returns an empty list rather than an error, so a caller can walk to exhaustion.
Response includes locations[], count, total, page, total_pages, source_url, and fetched_at. Each entry has name, path, latitude/longitude (present only for source: "map" entries), and source.
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| name | 40 | “14th Street Logan Circle Kiosk (X)” and 39 other values |
| path | 40 | “node/51711” and 39 other values |
| latitude | 40 | |
| longitude | 40 | |
| source | 40 | map in all 40 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| page | integer | No | 1-based page (default 1) | 1 | |
| page_size | integer | No | Entries per page, 1-500 (default 100) | 100 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/shakeshack/locations?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"locations": [
{
"name": "Meyerland",
"path": "location/meyerland-tx",
"source": "list"
},
{
"name": "Citi Field, NYC",
"path": "node/15226",
"latitude": 40.758268,
"longitude": -73.845572,
"source": "map"
}
],
"count": 2,
"total": 1322,
"page": 1,
"total_pages": 14,
"source_url": "https://shakeshack.com/locations",
"fetched_at": "2026-09-03T17:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/shakeshack.locationsResponseDoc
| 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 | shakeshack.LocationsResponse | No | ||||
| data.count | integer | No | 100 | |||
| data.fetched_at | string | No | ||||
| data.locations | array | No | ||||
| data.locations[].latitude | number | No | 29.6856442 | Latitude/Longitude are present only for entries sourced from the map section (source "map"). Fetch GET /shakeshack/store for coordinates on a "list"-sourced entry. | ||
| data.locations[].longitude | number | No | -95.4574726 | |||
| data.locations[].name | string | No | Meyerland | |||
| data.locations[].path | string | No | location/meyerland-tx | Path is the value GET /shakeshack/store takes, e.g. "location/meyerland-tx" or "node/15226". | ||
| data.locations[].source | string | No | list | Source is which section of the /locations page this entry was parsed from, not a business classification: "list" is Shake Shack's own "Full List of Locations" text index (structured address, no coordinates); "map" is the interactive map's pin data (coordinates, no structured address). Both round-trip through GET /shakeshack/store by path. | ||
| data.page | integer | No | 1 | |||
| data.source_url | string | No | ||||
| data.total | integer | No | 1322 | |||
| data.total_pages | integer | No | 14 | |||
| 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/shakeshack/locations?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"