Swiggy API reference

Swiggy Area Restaurants

swiggy.area.restaurants

Restaurants across a whole area: give a city box or a centre and radius, and get one list of restaurants without duplicates.

Swiggy Area Restaurants API: overview and live sample

At a glance

Endpoint ID: swiggy.area.restaurants
Price: 3–25 credits per call; failed calls are free
Runs for up to: 120 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: swiggy__area__restaurants; Pin tools
OpenAPI: openapi.json; Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "swiggy.area.restaurants",  "input": {    "center_latitude": 12.9121181,    "center_longitude": 77.6445548,    "max_cells": 1,    "max_pages_per_cell": 1,    "max_restaurants": 20,    "page_limit": 10,    "radius_km": 0.5,    "step_km": 1  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "swiggy.area.restaurants",  "input": {    "center_latitude": 12.9121181,    "center_longitude": 77.6445548,    "max_cells": 1,    "max_pages_per_cell": 1,    "max_restaurants": 20,    "page_limit": 10,    "radius_km": 0.5,    "step_km": 1  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "swiggy.area.restaurants",  "input": {    "center_latitude": 12.9121181,    "center_longitude": 77.6445548,    "max_cells": 1,    "max_pages_per_cell": 1,    "max_restaurants": 20,    "page_limit": 10,    "radius_km": 0.5,    "step_km": 1  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

Field	Type	Required	What it does	Example
`center_latitude`	number	no	Centre of the area, for a radius search.	12.9121181
`center_longitude`	number	no	Centre of the area, for a radius search.	77.6445548
`city`	string	no	A city name, as an alternative to coordinates.
`concurrency`	integer	no	How many points to check at once.
`max_cells`	integer	no	The most points to check across the area.	1
`max_latitude`	number	no	Northern edge of the area box.
`max_longitude`	number	no	Eastern edge of the area box.
`max_pages_per_cell`	integer	no	Kept for older requests; one listing is read per point.	1
`max_restaurants`	integer	no	The most restaurants to return.	20
`min_latitude`	number	no	Southern edge of the area box.
`min_longitude`	number	no	Western edge of the area box.
`page_limit`	integer	no	Kept for older requests; each point returns its whole listing.	10
`radius_km`	number	no	How far from the centre to look, in kilometres.	0.5
`step_km`	number	no	Spacing between the points checked across the area, in kilometres. Smaller finds more restaurants and takes longer.	1

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data

{  "summary": {    "cells": 1,    "has_more": true,    "total_items": 20  },  "items": [    {      "name": "Andhra Gunpowder",      "rating": 4.3,      "area_name": "HSR Layout",      "cell_id": "cell-0001",      "cell_latitude": 12.907614,      "cell_longitude": 77.639933,      "cell_rank": 1,      "cost_for_two_minor": 35000,      "cost_for_two_text": "₹350 for two",      "cuisines_text": "Andhra, Biryani, South Indian",      "delivery_time_minutes": 34,      "is_open": true,      "last_mile_travel_km": 0.9,      "last_mile_travel_text": "0.9 km",      "latitude": 12.907614,      "locality": "Sector 2",      "longitude": 77.639933,      "parent_id": "10496",      "rating_text": "4.3",      "restaurant_id": "279024",      "restaurant_url": "https://www.swiggy.com/city/bangalore/andhra-gunpowder-sector-2-hsr-layout-rest279024",      "serviceability": "SERVICEABLE",      "sla_text": "30-35 mins",      "total_ratings_text": "9.7K+",      "cuisines": [        "Andhra",        "Biryani"      ]    },    {      "name": "Aligarh House",      "rating": 4.3,      "area_name": "HSR Layout",      "cell_id": "cell-0001",      "cell_latitude": 12.907614,      "cell_longitude": 77.639933,      "cell_rank": 1,      "cost_for_two_minor": 40000,      "cost_for_two_text": "₹400 for two",      "cuisines_text": "Biryani, Mughlai, Kebabs, Lucknowi, Fast Food, Desserts, Beverages",      "delivery_time_minutes": 28,      "is_open": true,      "last_mile_travel_km": 0.7,      "last_mile_travel_text": "0.7 km",      "latitude": 12.907614,      "locality": "HSR Layout",      "longitude": 77.639933,      "parent_id": "586111",      "rating_text": "4.3",      "restaurant_id": "81642",      "restaurant_url": "https://www.swiggy.com/city/bangalore/aligarh-house-hsr-layout-rest81642",      "serviceability": "SERVICEABLE",      "sla_text": "25-30 mins",      "total_ratings_text": "11K+",      "cuisines": [        "Biryani",        "Mughlai"      ]    }  ]}

Fields

Field	Type	What it is	Example
`items[].name`	string	The name of the restaurant or dish.	Andhra Gunpowder
`items[].cuisines_text`	string	The cuisines as one line.	Andhra, Biryani, South Indian
`items[].rating`	number	The average rating, out of 5.	4.3
`items[].cost_for_two_text`	string	Swiggy's price guide for two people.	₹350 for two
`items[].delivery_time_minutes`	integer	Swiggy's delivery time estimate, in minutes.	34
`items[].locality`	string	The restaurant's locality.	Sector 2
`items[].area_name`	string	The area of the restaurant.	HSR Layout
`items[].cell_id`	string	The grid cell the area search used.	cell-0001
`items[].cell_latitude`	number	The grid cell's latitude.	12.91
`items[].cell_longitude`	number	The grid cell's longitude.	77.64
`items[].cell_rank`	integer	The place within that grid cell.	1
`items[].cost_for_two_minor`	integer	The price guide for two, in paise.	35,000
`items[].cuisines`	array	The restaurant's cuisines.	Andhra, Biryani, South Indian
`items[].is_open`	boolean	Whether the restaurant is open now.	true
`items[].last_mile_travel_km`	number	Distance from the restaurant to you, in kilometres.	0.9
`items[].last_mile_travel_text`	string	That distance as Swiggy shows it.	0.9 km
`items[].latitude`	number	Latitude.	12.91
`items[].longitude`	number	Longitude.	77.64
`items[].parent_id`	string		10496
`items[].rating_text`	string	The rating as Swiggy shows it.	4.3
`items[].restaurant_id`	string	Swiggy's ID for the restaurant, used by the menu endpoint.	279024
`items[].restaurant_url`	string	The restaurant's page on Swiggy.	https://www.swiggy.com/city/bangalore/andhra-gunpowder-sector-2…
`items[].serviceability`	string	Whether the restaurant delivers to your location.	SERVICEABLE
`items[].sla_text`	string	Swiggy's delivery time estimate.	30-35 mins
`items[].total_ratings_text`	string	How many ratings, as Swiggy rounds it.	9.7K+
`items`	array	The results.	20 records
`summary`	object	Totals for this response.	3 fields
`summary.cells`	integer	How many grid cells the area search covered.	1
`summary.has_more`	boolean	Whether more results follow this page.	true
`summary.total_items`	integer	How many results this response holds.	20

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Swiggy endpoints

Something missing or unclear? Ask the team that builds the Swiggy endpoints.