# Area Menu Items Grid Crawl a Swiggy area grid and stream deduplicated menu items. - Platform: [Swiggy](https://docs.upscrape.com/docs/platforms/swiggy) - Capability ID: `swiggy.area.menu_items` - 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, "continue_on_menu_failures": true, "max_cells": 1, "max_pages_per_cell": 1, "max_restaurants": 2, "menu_item_limit": 5, "page_limit": 10, "radius_km": 1, "step_km": 1 }, "capability": "swiggy.area.menu_items" }' ``` ## 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. | | `continue_on_menu_failures` | `boolean` | No | Continue if a menu fetch fails. | | `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. | | `menu_item_limit` | `integer` | No | Maximum menu items per restaurant. | | `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, "continue_on_menu_failures": true, "max_cells": 1, "max_pages_per_cell": 1, "max_restaurants": 2, "menu_item_limit": 5, "page_limit": 10, "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": [ { "variant_group_names_text": "Choice of Cheese", "restaurant_locality": "5TH SECTOR", "variant_group_count": 1, "category": "Korean Burgers", "rating": 4.5, "restaurant_city": "Bangalore", "restaurant_cuisines_text": "Bubble Tea, Burger", "restaurant_rating_text": "4.2", "rating_count": "25 ratings", "addon_group_names": [ "Select Your Pickle" ], "restaurant_rating": 4.2, "final_price_minor": 15800, "item_id": "149623609", "image_id": "FOOD_CATALOG/IMAGES/CMS/2024/10/24/[redacted:token].jpg_compressed", "in_stock": true, "restaurant_name": "Boba Bhai - Bubble Tea & Korean Street Food", "default_price_minor": 28900, "description": "The Golden Fried Veg Patty Topped with our in house burger sauce, onions, Lettuce and freshly baked bun. We do not add Tomatoes in our burger.", "name": "The OG Veggie Burger", "source_url": "[redacted:acquisition_url]", "cell_id": "cell-0001", "restaurant_id": "819617", "offer_ids": [ "ced9fdd2-3b85-4772-a459-1a9f2a3eb833" ], "restaurant_url": "https://www.swiggy.com/city/bangalore/boba-bhai-5th-sector-hsr-rest819617", "cell_longitude": 77.635312, "is_veg": true, "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/FOOD_CATALOG/IMAGES/CMS/2024/10/24/[redacted:token].jpg_compressed", "restaurant_area_name": "HSR Layout", "crawl_id": "050786af-f034-4ef9-bbf6-0a6ef9baed94", "addon_group_count": 1, "variant_group_names": [ "Choice of Cheese" ], "offer_ids_text": "ced9fdd2-3b85-4772-a459-1a9f2a3eb833", "cell_rank": 1, "cell_latitude": 12.903109, "restaurant_cuisines": [ "Bubble Tea", "Burger" ], "addon_group_names_text": "Select Your Pickle" }, { "variant_group_names_text": "Choice of Cheese", "restaurant_locality": "5TH SECTOR", "variant_group_count": 1, "category": "Korean Burgers", "rating": 4.7, "restaurant_city": "Bangalore", "restaurant_cuisines_text": "Bubble Tea, Burger", "restaurant_rating_text": "4.2", "rating_count": "19 ratings", "addon_group_names": [ "Select Your Pickle" ], "restaurant_rating": 4.2, "final_price_minor": 15800, "item_id": "149623583", "image_id": "FOOD_CATALOG/IMAGES/CMS/2024/10/24/[redacted:token].jpg", "in_stock": true, "restaurant_name": "Boba Bhai - Bubble Tea & Korean Street Food", "default_price_minor": 28900, "description": "Minced Chicken Patty fried to perfection topped with House Mayo, Lettuce and Tangy Chipotle Sauce on Fresh warm bun.", "name": "Crispy Chicken Burger (VR)", "source_url": "[redacted:acquisition_url]", "cell_id": "cell-0001", "restaurant_id": "819617", "offer_ids": [ "ced9fdd2-3b85-4772-a459-1a9f2a3eb833" ], "restaurant_url": "https://www.swiggy.com/city/bangalore/boba-bhai-5th-sector-hsr-rest819617", "cell_longitude": 77.635312, "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/FOOD_CATALOG/IMAGES/CMS/2024/10/24/[redacted:token].jpg", "restaurant_area_name": "HSR Layout", "crawl_id": "050786af-f034-4ef9-bbf6-0a6ef9baed94", "addon_group_count": 1, "variant_group_names": [ "Choice of Cheese" ], "offer_ids_text": "ced9fdd2-3b85-4772-a459-1a9f2a3eb833", "cell_rank": 1, "cell_latitude": 12.903109, "restaurant_cuisines": [ "Bubble Tea", "Burger" ], "addon_group_names_text": "Select Your Pickle" }, { "addon_group_count": 1, "addon_group_names": [ "Choice of Dip" ], "addon_group_names_text": "Choice of Dip", "category": "New & Trending", "cell_id": "cell-0001", "cell_latitude": 12.903109, "cell_longitude": 77.635312, "cell_rank": 1, "crawl_id": "050786af-f034-4ef9-bbf6-0a6ef9baed94", "description": "Crispy golden rings coated with a crunchy breadcrumb crust and filled with rich, gooey melted cheese inside — perfectly fried to deliver a satisfying crunch on the outside and a creamy, cheesy burst in every bite.", "final_price_minor": 19900, "image_id": "FOOD_CATALOG/IMAGES/CMS/2026/6/25/[redacted:token].jpg", "image_url": "https://media-assets.swiggy.com/swiggy/image/upload/FOOD_CATALOG/IMAGES/CMS/2026/6/25/[redacted:token].jpg", "in_stock": true, "is_veg": true, "item_id": "203754873", "name": "Crispy Cheese Rings", "offer_ids": [ "cc992051-e5ad-4be3-a6bc-2a429a49ab42" ], "offer_ids_text": "cc992051-e5ad-4be3-a6bc-2a429a49ab42", "price_minor": 24900, "restaurant_area_name": "HSR Layout", "restaurant_city": "Bangalore", "restaurant_cuisines": [ "Bubble Tea", "Burger" ], "restaurant_cuisines_text": "Bubble Tea, Burger", "restaurant_id": "819617", "restaurant_locality": "5TH SECTOR", "restaurant_name": "Boba Bhai - Bubble Tea & Korean Street Food", "restaurant_rating": 4.2, "restaurant_rating_text": "4.2", "restaurant_url": "https://www.swiggy.com/city/bangalore/boba-bhai-5th-sector-hsr-rest819617", "source_url": "[redacted:acquisition_url]" } ], "summary": { "cells": 1, "crawl_id": "050786af-f034-4ef9-bbf6-0a6ef9baed94", "source_url": "[redacted:acquisition_url]", "total_items": 10 } } ``` ### 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` | 1 | | `summary.crawl_id` | `string` | 050786af-f034-4ef9-bbf6-0a6ef9baed94 | | `summary.source_url` | `string` | [redacted:acquisition_url] | | `summary.total_items` | `integer` | 10 | ## 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)