# Area Restaurants Crawl a Swiggy area grid and stream deduplicated restaurant rows. - Platform: [Swiggy](https://docs.upscrape.com/docs/platforms/swiggy) - Capability ID: `swiggy.area.restaurants` - Cost: 1 credit per request - Maximum runtime: 120 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "center_latitude": 12.9121181, "center_longitude": 77.6445548, "max_cells": 2, "max_pages_per_cell": 1, "max_restaurants": 50, "page_limit": 20, "radius_km": 1, "step_km": 1 }, "capability": "swiggy.area.restaurants" }' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `center_latitude` | `number` | No | Center latitude for radius mode. | | `center_longitude` | `number` | No | Center longitude for radius mode. | | `city` | `string` | No | City name. | | `concurrency` | `integer` | No | Number of concurrent requests. | | `max_cells` | `integer` | No | Maximum grid cells to crawl. | | `max_latitude` | `number` | No | Maximum latitude of bounding box. | | `max_longitude` | `number` | No | Maximum longitude of bounding box. | | `max_pages_per_cell` | `integer` | No | Maximum pages per cell. | | `max_restaurants` | `integer` | No | Maximum restaurants to return. | | `min_latitude` | `number` | No | Minimum latitude of bounding box. | | `min_longitude` | `number` | No | Minimum longitude of bounding box. | | `page_limit` | `integer` | No | Results per page. | | `radius_km` | `number` | No | Radius in kilometers. | | `step_km` | `number` | No | Grid step size in kilometers. | ### Example input ```json { "center_latitude": 12.9121181, "center_longitude": 77.6445548, "max_cells": 2, "max_pages_per_cell": 1, "max_restaurants": 50, "page_limit": 20, "radius_km": 1, "step_km": 1 } ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This redacted fixture is an example, not a fixed response schema. ```json { "items": [ { "area_name": "HSR Layout", "cell_id": "cell-0001", "cell_latitude": 12.903109, "cell_longitude": 77.635312, "cell_rank": 1, "cloudinary_image_id": "RX_THUMBNAIL/IMAGES/VENDOR/2026/6/15/[redacted:token].JPG", "cost_for_two_minor": "₹300 for two", "cost_for_two_text": "₹300 for two", "crawl_id": "370dccd0-c950-4726-8152-edb5499068ed", "cuisines": [ "Pizzas" ], "cuisines_text": "Pizzas", "delivery_time_minutes": 29, "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/RX_THUMBNAIL/IMAGES/VENDOR/2026/6/15/[redacted:token].JPG", "is_open": true, "last_mile_travel_km": 1.7, "last_mile_travel_text": "1.7 km", "latitude": 12.903109, "locality": "14th Main", "longitude": 77.635312, "name": "Pizza Hut", "offer_headers": [ "50% OFF" ], "offer_text": "50% OFF", "parent_id": "721", "rating": 4, "rating_text": "4.0", "restaurant_id": "10581", "restaurant_url": "https://www.swiggy.com/city/bangalore/[redacted:token]", "serviceability": "SERVICEABLE", "sla_text": "25-30 mins", "source_url": "[redacted:acquisition_url]", "total_ratings_text": "21K+" }, { "area_name": "HSR Layout", "cell_id": "cell-0001", "cell_latitude": 12.903109, "cell_longitude": 77.635312, "cell_rank": 1, "cloudinary_image_id": "RX_THUMBNAIL/IMAGES/VENDOR/2024/11/7/[redacted:token].jpg", "cost_for_two_minor": "₹200 for two", "cost_for_two_text": "₹200 for two", "crawl_id": "370dccd0-c950-4726-8152-edb5499068ed", "cuisines": [ "Bubble Tea", "Burger", "Korean" ], "cuisines_text": "Bubble Tea, Burger, Korean, Beverages, Fast Food, Juice and shake", "delivery_time_minutes": 34, "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/RX_THUMBNAIL/IMAGES/VENDOR/2024/11/7/[redacted:token].jpg", "is_open": true, "last_mile_travel_km": 2.8, "last_mile_travel_text": "2.8 km", "latitude": 12.903109, "locality": "5TH SECTOR", "longitude": 77.635312, "name": "Boba Bhai - Bubble Tea & Korean Street Food", "offer_headers": [ "60% OFF" ], "offer_text": "60% OFF", "parent_id": "361235", "rating": 4.2, "rating_text": "4.2", "restaurant_id": "819617", "restaurant_url": "https://www.swiggy.com/city/bangalore/[redacted:token]", "serviceability": "SERVICEABLE", "sla_text": "30-35 mins", "source_url": "[redacted:acquisition_url]", "total_ratings_text": "1.2K+" }, { "area_name": "HSR Layout", "cell_id": "cell-0001", "cell_latitude": 12.903109, "cell_longitude": 77.635312, "cell_rank": 1, "cloudinary_image_id": "RX_THUMBNAIL/IMAGES/VENDOR/2026/6/18/[redacted:token].JPG", "cost_for_two_minor": "₹400 for two", "cost_for_two_text": "₹400 for two", "crawl_id": "370dccd0-c950-4726-8152-edb5499068ed", "cuisines": [ "Burgers", "Beverages", "Cafe" ], "cuisines_text": "Burgers, Beverages, Cafe, Desserts", "delivery_time_minutes": 26, "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/RX_THUMBNAIL/IMAGES/VENDOR/2026/6/18/[redacted:token].JPG", "is_open": true, "last_mile_travel_km": 1.4, "last_mile_travel_text": "1.4 km", "latitude": 12.903109, "locality": "HSR Layout", "longitude": 77.635312, "name": "McDonald's", "offer_headers": [ "ITEMS" ], "offer_text": "ITEMS", "parent_id": "630", "rating": 4.3, "rating_text": "4.3", "restaurant_id": "23682", "restaurant_url": "https://www.swiggy.com/city/bangalore/mcdonalds-hsr-layout-rest23682", "serviceability": "SERVICEABLE", "sla_text": "25-30 mins", "source_url": "[redacted:acquisition_url]", "total_ratings_text": "79K+" } ], "summary": { "cells": 2, "crawl_id": "370dccd0-c950-4726-8152-edb5499068ed", "source_url": "[redacted:acquisition_url]", "total_items": 26 } } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `items` | `array` | 3 items | | `items` | `array` | 3 items | | `summary` | `object` | 4 fields | | `summary.cells` | `integer` | 2 | | `summary.crawl_id` | `string` | 370dccd0-c950-4726-8152-edb5499068ed | | `summary.source_url` | `string` | [redacted:acquisition_url] | | `summary.total_items` | `integer` | 26 | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)