Swiggy API endpoint
Use Crawlora's Swiggy Search API to extract supported public Swiggy data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.
/swiggy/searchReturns restaurants delivering to a latitude/longitude, optionally filtered by a keyword or browsed within a curated collection. With no query and no collection_id this browses the nearby-restaurant listing; with a query it runs a keyword search across restaurant names, cuisines, and dishes; with a collection_id (from /swiggy/collections) it browses restaurants within that curated collection. query and collection_id are mutually exclusive. Keyword search has two result tabs, selected with tab: dish (the default) returns restaurants that serve a matching dish, each with the matching dishes, their prices, and Swiggy's own per-dish rating where it has one, in a dishes array; restaurant returns restaurants whose own name or cuisine matches, a wider set with no dishes. tab, veg, min_rating and offers are only valid together with query. sort works with either query (relevance, delivery_time, rating) or collection_id (those three plus cost_low_to_high and cost_high_to_low), and is rejected on a plain nearby browse. Each restaurant carries its id (the value the restaurant and menu endpoints take), name, cuisines, cost for two, rating, delivery time, open/closed status, a hero image, and, where one is shown, an external_rating block with the third-party aggregate score, count, and source. Where the result card advertises a promotion it also carries offers, the same title/description/tag shape /swiggy/restaurant returns (a listing card never carries a coupon code, and a card showing both a discount and a separate free-delivery benefit returns them as two entries). is_promoted is present and true only for a result Swiggy itself labels a sponsored placement rather than an organic one. unavailable_message is present only when Swiggy says the restaurant cannot currently be ordered from and carries its own reason; it is not the inverse of is_open, since Swiggy reports a restaurant as open while still refusing orders for the requested location. A plain nearby browse also returns is_serviceable, which says whether Swiggy delivers to the requested coordinates at all: false means the coordinates are outside Swiggy's delivery coverage, so the empty restaurants list is a coverage answer rather than a no-matches answer, while an empty list without the field means no matches in a served area. It is omitted on keyword search and on a collection_id browse, neither of which carries Swiggy's own coverage marker. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.
Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Search center latitude | ||
| longitude | number | Yes | Search center longitude | ||
| query | string | No | Optional keyword to search restaurants and dishes by, at least 2 characters. Mutually exclusive with collection_id. | ||
| collection_id | string | No | Optional curated collection id from /swiggy/collections's id field. Browses restaurants within that collection instead of the plain nearby listing. Mutually exclusive with query. | ||
| sort | string | No | Optional sort order. With query: relevance, delivery_time, rating. With collection_id: those three plus cost_low_to_high and cost_high_to_low. Not valid on a plain nearby browse. Allowed values: relevance, delivery_time, rating, cost_low_to_high, cost_high_to_low | ||
| offset | string | No | Opaque pagination cursor from a prior response's next_offset (not meaningful when query is set) | ||
| tab | string | No | Which keyword-search result tab to read: dish (default, restaurants serving a matching dish, each with a dishes array) or restaurant (restaurants whose own name/cuisine matches). Only valid together with query. Allowed values: dish, restaurant | ||
| veg | boolean | No | Only return vegetarian results: veg dishes on tab=dish, pure-veg restaurants on tab=restaurant. Only valid together with query. | ||
| min_rating | number | No | Only return restaurants rated at or above this score (0-5). Only valid together with query. | ||
| offers | boolean | No | Only return restaurants currently running an offer. Only valid together with query. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/swiggy/search?query=coffee&sort=relevance&tab=dish&veg=true&offers=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
This endpoint is executed through Crawlora's managed scraping infrastructure.
Crawlora does not silently return bad data when the upstream page cannot be used.
| Status | Common failure case |
|---|---|
| 400 | Invalid input or missing required parameter |
| 429 | Plan or endpoint rate limit exceeded |
| 500 | Internal execution error |
| 502 | Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved |
When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
{
"code": 200,
"msg": "OK",
"data": {
"restaurants": [
{
"id": "537139",
"name": "Narmada Chain of Restaurant",
"locality": "Koramangala",
"area": "Koramangala",
"cuisines": [
"Biryani",
"Andhra",
"South Indian"
],
"cost_for_two": "₹500 for two",
"rating": 4.4,
"rating_count": "13K+",
"external_rating": {
"source": "GOOGLE",
"rating": 4.2,
"count": "2.6K+"
},
"delivery_time_minutes": 51,
"is_open": true,
"image_url": "https://media-assets.swiggy.com/swiggy/image/upload/fl_lossy,f_auto,q_auto/RX_THUMBNAIL/IMAGES/VENDOR/2025/11/29/753d7fd4-a3f2-46d0-b803-4e1682b33109_537139.jpg",
"offers": [
{
"title": "ITEMS",
"description": "AT ₹39"
},
{
"title": "Free Delivery"
}
],
"is_promoted": true
}
],
"next_offset": "CJhlELQ4KICY0ZzT+sHYBDCnEw==",
"is_serviceable": true
}
}Request schema
No body schema
Response schema
#/definitions/swiggy.searchResponseDoc
| 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 | swiggy.SearchResponse | No | ||||
| data.is_serviceable | boolean | No | IsServiceable reports whether Swiggy delivers to the requested coordinates at all. False means the coordinates are outside Swiggy's delivery coverage, so an empty restaurants list is a coverage answer rather than a no-matches answer; an empty list without this field means no matches in a served area. Returned only for the plain nearby browse -- keyword search and a collection_id browse omit it, because Swiggy answers neither with a coverage verdict. | |||
| data.next_offset | string | No | ||||
| data.restaurants | array | No | ||||
| data.restaurants[].address | string | No | ||||
| data.restaurants[].area | string | No | ||||
| data.restaurants[].city | string | No | ||||
| data.restaurants[].cost_for_two | string | No | ||||
| data.restaurants[].cuisines | array | No | ||||
| data.restaurants[].delivery_time_minutes | integer | No | ||||
| data.restaurants[].dishes | array | No | Dishes are the menu items that actually matched a /swiggy/search query, carried only by Swiggy's own "Dishes" search tab (tab=dish). Empty on the restaurant tab, on a plain nearby browse, on a collection browse, and on /swiggy/restaurant -- none of those upstream shapes carry per-restaurant dish matches. | |||
| data.restaurants[].dishes[].category | string | No | ||||
| data.restaurants[].dishes[].description | string | No | ||||
| data.restaurants[].dishes[].discounted_price | number | No | ||||
| data.restaurants[].dishes[].id | string | No | ||||
| data.restaurants[].dishes[].image_url | string | No | ||||
| data.restaurants[].dishes[].in_stock | boolean | No | ||||
| data.restaurants[].dishes[].is_veg | boolean | No | ||||
| data.restaurants[].dishes[].name | string | No | ||||
| data.restaurants[].dishes[].price | number | No | ||||
| data.restaurants[].dishes[].rating | number | No | Rating and TotalRatings are Swiggy's own aggregate score and review count for this individual dish, the same two fields a restaurant carries. Omitted when the dish has no rating yet. Only the headline aggregate is returned -- individual reviews and reviewer identity are out of scope for this platform. | |||
| data.restaurants[].dishes[].total_ratings | integer | No | ||||
| data.restaurants[].external_rating | swiggy.ExternalRating | No | ||||
| data.restaurants[].external_rating.count | string | No | ||||
| data.restaurants[].external_rating.rating | number | No | ||||
| data.restaurants[].external_rating.source | string | No | ||||
| data.restaurants[].hours_message | string | No | ||||
| data.restaurants[].hours_status | string | No | HoursStatus/HoursMessage are Swiggy's own live open/close callout for this outlet ("Open now" / "Closes 11:30 pm"); OpeningHours is its weekly schedule. Only the restaurant detail and menu responses carry these -- search and collection listing cards do not, so they are empty on /swiggy/search results. | |||
| data.restaurants[].id | string | No | ||||
| data.restaurants[].image_url | string | No | ||||
| data.restaurants[].is_open | boolean | No | ||||
| data.restaurants[].is_promoted | boolean | No | IsPromoted reports whether Swiggy itself labels this a promoted (sponsored, paid-placement) result rather than an organic one. Present and true only for those; Swiggy marks none on a plain nearby browse. | |||
| data.restaurants[].latitude | number | No | ||||
| data.restaurants[].locality | string | No | ||||
| data.restaurants[].longitude | number | No | ||||
| data.restaurants[].name | string | No | ||||
| data.restaurants[].offers | array | No | Offers are the promotions Swiggy shows on this restaurant's own listing card in a search, browse, or collection result -- the headline discount and its condition, its badge, and any separate free-delivery benefit. Absent when the card shows no promotion, and on /swiggy/restaurant and /swiggy/restaurant/menu, whose responses carry the restaurant's fuller offer list at the top level instead. | |||
| data.restaurants[].offers[].coupon_code | string | No | ||||
| data.restaurants[].offers[].description | string | No | ||||
| data.restaurants[].offers[].tag | string | No | ||||
| data.restaurants[].offers[].title | string | No | ||||
| data.restaurants[].opening_hours | array | No | ||||
| data.restaurants[].opening_hours[].day | string | No | ||||
| data.restaurants[].opening_hours[].hours | string | No | ||||
| data.restaurants[].phone | string | No | ||||
| data.restaurants[].postal_code | string | No | ||||
| data.restaurants[].rating | number | No | ||||
| data.restaurants[].rating_count | string | No | ||||
| data.restaurants[].total_ratings | integer | No | ||||
| data.restaurants[].unavailable_message | string | No | UnavailableMessage is Swiggy's own reason this listed restaurant cannot be ordered from right now ("Currently not taking orders for this location", "Opens next at 5 pm, today", "Temporarily closed for delivery"). Absent for a restaurant that is currently orderable. Note it is not simply the inverse of is_open: a restaurant Swiggy reports as open can still be unavailable for the requested location. | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/swiggy/search?query=coffee&sort=relevance&tab=dish&veg=true&offers=true" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora terms