API referenceSwiggy
Swiggy search
Keyword search for Swiggy outlets near a point.
Reaches considerably further than the listing does, a broad query returns 100-350 outlets against the listing's ~25, because search is not confined to the immediate delivery radius. It is the better primitive for enumerating a city, and returns the whole result set in one call.
Results mix organic and paid rows; the paid ones carry promoted: true so
they can be dropped or kept deliberately.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/swiggy-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "pizza", "city": "bangalore" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "city": "bangalore", "has_more": false, "latitude": 12.9716, "longitude": 77.5946, "outlets": [ { "area": "Indiranagar", "brand_id": "11785", "cost_for_two": 200, "cost_for_two_text": "₹200 FOR TWO", "cuisines": [ "Italian", "Desserts", "… 3 more items in the full response" ], "delivery_time_minutes": 45, "delivery_time_text": "45-50 MINS", "distance_km": 6.5, "google_rating": { "rating": 4.1, "rating_count_text": "9.2K+", "source": "GOOGLE" }, "image": "https://media-assets.swiggy.com/swiggy/image/upload/2f2a8e30d98db46c6507105f68151cf9", "is_open": true, "locality": "CMH Road", "name": "Onesta", "offers": [ "50% OFF (FLAT DEAL)" ], "promoted": true, "rating": 3.7, "rating_count_text": "13K+", "restaurant_id": "401186", "serviceable": true, "url": "https://www.swiggy.com/city/bangalore/onesta1-cmh-road-indiranagar-rest401186" }, { "area": "Central Bangalore", "brand_id": "522292", "cost_for_two": 700, "cost_for_two_text": "₹700 FOR TWO", "cuisines": [ "Pizzas", "Pastas", "… 3 more items in the full response" ], "delivery_time_minutes": 25, "delivery_time_text": "25-30 MINS", "distance_km": 1.5, "google_rating": { "rating": 4.3, "rating_count_text": "3.0K+", "source": "GOOGLE" }, "image": "https://media-assets.swiggy.com/swiggy/image/upload/493e6b5462e84f5477b1962c469fc5a6", "is_open": true, "locality": "Church Street", "name": "The Pizza Bakery - Wood Fired Sourdough", "offers": [ "70% OFF" ], "rating": 4.6, "rating_count_text": "7.5K+", "restaurant_id": "342643", "serviceable": true, "url": "https://www.swiggy.com/city/bangalore/the-pizza-bakery-central-bangalore-central-bangalore-rest342643" }, "… 100 more items in the full response" ], "query": "pizza", "returned": 102 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "swiggy-search-v4", "billable": true, "duration_ms": 5410 }}