Zomato API endpoint
Returns one Zomato curated collection's restaurant list (name, cuisines, locality, rating, and headline review count where Zomato's own response includes them). Reads the same underlying page-render source as /zomato/restaurant and /zomato/restaurant/menu, pointed at the collection's own page instead of a restaurant's.
/zomato/collectionQuery parameters:
url (required) — canonical public Zomato collection URL, from /zomato/collections's url field, e.g. https://www.zomato.com/mumbai/best-bars-and-pubs. A URL with a query string or fragment, a non-zomato.com host, or a path with other than exactly two segments (city + collection slug) is rejected as invalid.An unrecognized collection URL returns a 404, whether Zomato has no such collection or has no collection pages for that city at all. Passing the city's own /collections hub URL here (rather than one specific collection) also returns a 404 — use /zomato/collections for the hub listing instead.
Response includes name, url, description (only present when Zomato's own response includes one), num_places (a display string, e.g. 54 Places), and restaurants[]. Each restaurant has id, name, url, type (restaurant or chain — Zomato groups some multi-outlet brands under a single chain entry within a collection), cuisines[], locality, rating, rating_count (a display string, e.g. 6,985), and image_url. Only Zomato's own headline aggregate rating and review count are included — no individual review text or reviewer identity, per this platform's catalog-only scope.
| Field | Filled in, of 52 checked | Values in the sample |
|---|---|---|
| id | 52 | |
| name | 52 | “BKC Dive.” and 51 other values |
| url | 52 | zomato.com |
| type | 52 | restaurant (48), chain (4) |
| cuisines | 52 | median 6 entries |
| locality | 52 | “Bandra Kurla Complex, Mumbai” and 21 other values |
| rating | 48 | 3.2 to 4.9, median 4.2 |
| rating_count | 48 | “21.5K” and 47 other values |
| image_url | 52 | b.zmtcdn.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical public Zomato collection URL, from /zomato/collections's url field | https://www.zomato.com/mumbai/best-bars-and-pubs | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/zomato/collection?url=https%3A%2F%2Fwww.zomato.com%2Fmumbai%2Fbest-bars-and-pubs" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"name": "Best pubs & bars",
"url": "https://www.zomato.com/mumbai/best-bars-and-pubs",
"description": "Bringing exciting flavours and oomph, these pubs and bars have got some really refreshing sips waiting for you.",
"num_places": "54 Places",
"restaurants": [
{
"id": "36277",
"name": "Sammy Sosa",
"url": "https://www.zomato.com/mumbai/restaurants/sammy-sosa",
"type": "chain",
"cuisines": [
"Mexican",
"Continental"
],
"locality": "Bandra West, Mumbai",
"rating": 4.3,
"rating_count": "1,204",
"image_url": "https://b.zmtcdn.com/data/pictures/7/36277/img.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/zomato.collectionResponseDoc
| 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 | zomato.CollectionResponse | No | ||||
| data.description | string | No | ||||
| data.name | string | No | ||||
| data.num_places | string | No | ||||
| data.restaurants | array | No | ||||
| data.restaurants[].cuisines | array | No | ||||
| data.restaurants[].id | string | No | ||||
| data.restaurants[].image_url | string | No | ||||
| data.restaurants[].locality | string | No | ||||
| data.restaurants[].name | string | No | ||||
| data.restaurants[].rating | number | No | ||||
| data.restaurants[].rating_count | string | No | ||||
| data.restaurants[].type | string | No | ||||
| data.restaurants[].url | string | No | ||||
| data.url | string | No | ||||
| 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 |
| 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/zomato/collection?url=https%3A%2F%2Fwww.zomato.com%2Fmumbai%2Fbest-bars-and-pubs" \
-H "x-api-key: $CRAWLORA_API_KEY"