Subway API endpoint
Returns one Subway store's bundle and combo categories with the price ranges they advertise -- min_bundled_price (cheapest as a bundle) and a_la_carte_price (cheapest bought separately). Unlike GET /subway/menu, which is US-only, this works in other markets: confirmed against US, GB and DE stores. It is NOT an itemised menu -- the upstream route behind it carries categories and prices only, with no individual products, no nutrition panels and no allergen disclosures. Use GET /subway/menu for a full itemised menu where it is available. A store with no bundles configured returns an empty categories array, which is a valid answer rather than an error. Store IDs come from a GET /subway/store or GET /subway/nearby result's store_id field.
/subway/combosThis is not an itemised menu. The upstream route behind it carries categories and their prices only — no individual products, no nutrition panels, and no allergen disclosures. Use /api/v1/subway/menu for a full itemised menu with nutrition and allergens, noting that it covers US stores only. This endpoint is the counterpart that works in other markets: confirmed against US, GB and DE stores.
Query parameters:
store_id (required) — store ID from a /api/v1/subway/store or /api/v1/subway/nearby result's store_id, e.g. 50916-0.culture (optional) — preferred translation culture for display names, e.g. en-US, en-GB, de-DE. An exact match wins; otherwise a translation sharing the same language is used; otherwise the category's default name is returned.Response includes store_id, categories[], count, source_url, and fetched_at.
Each categories[] entry has id, name, description (often empty upstream), sort_order, parent_id (set only for a nested category), min_bundled_price (cheapest advertised price for the category as a bundle) and a_la_carte_price (cheapest for buying its contents separately). Both price fields are omitted entirely when the upstream publishes no price — an absent price is not the same as a price of 0.
Categories are returned in the upstream's own sort_order, then by id, so repeated calls give a stable order.
A store with no bundles configured returns an empty categories array with count: 0. That is a valid answer, not an error — some markets genuinely publish none. An unknown store ID returns 404.
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| id | 6 | |
| name | 6 | “Sub Meal Deal (App)” and 5 other values |
| sort_order | 6 | 1 to 30, median 3 |
| parent_id | 5 | |
| min_bundled_price | 6 | 3.79 to 8.19, median 7.29 |
| a_la_carte_price | 6 | 4.98 to 19.77, median 15.67 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| store_id | string | Yes | Store ID from a /subway/store or /subway/nearby result's store_id | 50916-0 | |
| culture | string | No | Preferred translation culture for display names, e.g. en-US, en-GB, de-DE. Falls back to the category's default name. | en-GB | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/subway/combos?store_id=50916-0" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"store_id": "50916-0",
"categories": [
{
"id": "6",
"name": "Sub Meal Deal (App)",
"sort_order": 36,
"min_bundled_price": 9.99,
"a_la_carte_price": 12.97
}
],
"count": 1,
"source_url": "https://www.subway.com/api/fresh-menu/50916-0",
"fetched_at": "2026-09-06T01:15:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/subway.combosResponseDoc
| 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 | subway.ComboResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].a_la_carte_price | number | No | 12.97 | |||
| data.categories[].description | string | No | Description comes from the matching translation when the upstream carries one; it is frequently empty. | |||
| data.categories[].id | string | No | 6 | |||
| data.categories[].min_bundled_price | number | No | 9.99 | MinBundledPrice is the cheapest advertised price for taking the category as a bundle; ALaCartePrice is the cheapest for buying its contents separately. Either can be absent, so both are pointers -- a missing price and a genuine 0.00 are different facts. | ||
| data.categories[].name | string | No | Sub Meal Deal | |||
| data.categories[].parent_id | string | No | ParentID is set for a category nested under another, empty for a top-level one. | |||
| data.categories[].sort_order | integer | No | 36 | |||
| data.count | integer | No | 6 | |||
| data.fetched_at | string | No | ||||
| data.source_url | string | No | ||||
| data.store_id | string | No | 50916-0 | |||
| 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/subway/combos?store_id=50916-0" \
-H "x-api-key: $CRAWLORA_API_KEY"