# Multi-location search Run one Zepto product query across up to ten delivery locations and return local result groups for comparison. - Platform: [Zepto](https://docs.upscrape.com/docs/platforms/zepto) - Capability ID: `zepto.search.multi_location` - Cost: 1 credit per request - Maximum runtime: 180 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 $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "limit": 2, "locations": [ { "pincode": "560067" }, { "latitude": 12.9716, "longitude": 77.5946 } ], "max_pages": 1, "query": "rice" }, "capability": "zepto.search.multi_location" }' ``` ## Input Provide query and locations. locations accepts 1 to 10 objects; each object contains either a six-digit pincode or both latitude and longitude. limit accepts 1 to 100 products per local search and max_pages accepts 1 to 20 product pages. | Field | Type | Required | Description | | --- | --- | --- | --- | | `limit` | `integer` | No | Maximum number of results to return. From 1 to 100. Default: `20`. | | `locations` | `array` | Yes | | | `locations[].latitude` | `number` | No | Latitude in decimal degrees. From -90 to 90. | | `locations[].longitude` | `number` | No | Longitude in decimal degrees. From -180 to 180. | | `locations[].pincode` | `string` | No | Six-digit Indian pincode. When provided, Upscrape resolves coordinates and the Zepto delivery store automatically. | | `max_pages` | `integer` | No | Maximum number of result pages to fetch. From 1 to 20. Default: `10`. | | `query` | `string` | Yes | Search query. | ### Example input ```json { "limit": 2, "locations": [ { "pincode": "560067" }, { "latitude": 12.9716, "longitude": 77.5946 } ], "max_pages": 1, "query": "rice" } ``` ## Response Successful output is returned in `results[0].data`. Results are grouped by requested location. Keep each group’s location attribution and treat product rows at different stores as separate observations rather than a deduplicated national SKU record. Apply the same bounded-search interpretation as zepto.search: returned rows and limits do not prove exhaustive inventory. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "captured_at": "2026-09-24T09:56:09.12695688Z", "query": "rice", "results": [ { "count": 2, "location": { "eta_minutes": 10, "eta_serviceable": true, "latitude": 12.9967012, "longitude": 77.758197, "pincode": "560067", "secondary_store_ids": [ "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ], "serviceable": true, "store_id": "e58fff62-7695-44c2-aba0-6bc96074bc64", "store_ids": [ "e58fff62-7695-44c2-aba0-6bc96074bc64", "0059ff6a-7eb0-477a-a7f5-69256f2c444b" ] }, "results": [ { "discount_amount_paise": 3100, "unit_of_measure": "KILOGRAM", "discounted_selling_price_paise": 6900, "product_type": "SELLABLESKU", "shelf_life_hours": 6576, "weight_in_gms": 1000, "country_of_origin": "India", "store_product_id": "33c96172-a2d0-5a68-8f3a-bda4fc002a6f", "manufacturer_name": "Unbranded", "in_stock": true, "discount_percent": 31, "max_allowed_quantity": 6, "primary_category_id": "2f7190d0-7c40-458b-b450-9a1006db3d95", "rating_average": 4.4, "mrp_paise": 10000, "description": null, "name": "BestValue Sona Masoori Raw Rice", "brand_id": "a37897a1-f7a9-48e9-bc13-f4bcb96dc6e1", "available_quantity": 6, "quantity": 20, "pack_size": 1, "l3_category_id": "3baaf8d0-e429-4b09-95bf-d6fc49a01360", "shelf_life_display": "6576 hours", "rank": 1, "brand": "BestValue", "formatted_pack_size": "1 pack (1 kg)", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1db25844-2d44-44ca-a286-7b5d802d3ca9.png", "product_variant_id": "638b44d5-ffcd-49f0-a524-634d48c8ddd6", "store_id": "e58fff62-7695-44c2-aba0-6bc96074bc64", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1db25844-2d44-44ca-a286-7b5d802d3ca9.png" ], "is_primary": true, "super_saver": true, "product_id": "d6348e25-7990-4ffd-b715-877e0d88eeb0", "selling_price_paise": 6900, "is_active": true, "product_url": "https://www.zepto.com/pn/bestvalue-sona-masoori-raw-rice/pvid/638b44d5-ffcd-49f0-a524-634d48c8ddd6", "pricing_campaigns": [ { "price_paise": 6900, "type": "SUPER_SAVER" } ] }, { "discount_amount_paise": 8400, "unit_of_measure": "KILOGRAM", "discounted_selling_price_paise": 38600, "product_type": "SELLABLESKU", "shelf_life_hours": 17520, "weight_in_gms": 5000, "country_of_origin": "India", "store_product_id": "db14cb64-1741-470a-a97d-b506d724354a", "manufacturer_name": "LT Foods Ltd", "in_stock": true, "discount_percent": 17, "max_allowed_quantity": 4, "primary_category_id": "2f7190d0-7c40-458b-b450-9a1006db3d95", "rating_average": 4.4, "mrp_paise": 47000, "description": "Daawat now presents the best aromatic Authentic & lightweight, Sona Masoori, rice which is sourced, from the best sona masoori growing areas of karnataka, telangana, & Andhra, such as raichur and koppal. It is aged to perfection which makes it the finest sona masoori. Daawat Sona Masoori Rice is the best way to make variety rice at home. Sona Masoori Rice has a lower calorie count than the standar…", "name": "Daawat Premium Sona Masoori Rice | Medium Grain", "brand_id": "8f0fa49a-9afe-41b5-b9bc-7fdea8af7d15", "available_quantity": 4, "quantity": 10, "pack_size": 5, "l3_category_id": "3baaf8d0-e429-4b09-95bf-d6fc49a01360", "shelf_life_display": "17520 hours", "rank": 2, "brand": "Daawat", "formatted_pack_size": "1 pack (5 kg)", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1a14cd2a-f8d1-478a-9a3b-5fede77e0f30.jpeg", "product_variant_id": "82e8f251-f6a6-4329-afdf-5a4cfdf636ed", "store_id": "e58fff62-7695-44c2-aba0-6bc96074bc64", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1a14cd2a-f8d1-478a-9a3b-5fede77e0f30.jpeg" ], "is_primary": true, "primary_subcategory_id": "9798b797-0db0-4b04-b198-31b0a5849318", "super_saver": true, "badges": [ { "name": "Sponsored", "type": "SPONSORED" } ], "product_id": "be47c97a-7abc-40d8-9a40-c6fe64026c3d", "selling_price_paise": 38600, "is_active": true, "product_url": "https://www.zepto.com/pn/daawat-premium-sona-masoori-rice-medium-grain/pvid/82e8f251-f6a6-4329-afdf-5a4cfdf636ed", "pricing_campaigns": [ { "price_paise": 38600, "type": "SUPER_SAVER" } ] } ] }, { "count": 2, "location": { "eta_minutes": 12, "eta_serviceable": true, "latitude": 12.9716, "longitude": 77.5946, "secondary_store_ids": [ "843e630a-7896-462d-b7cf-712140483ed3" ], "serviceable": true, "store_id": "b1403534-cd6b-49d0-a7cd-ce20e6497768", "store_ids": [ "b1403534-cd6b-49d0-a7cd-ce20e6497768", "843e630a-7896-462d-b7cf-712140483ed3" ] }, "results": [ { "discount_amount_paise": 3100, "unit_of_measure": "KILOGRAM", "discounted_selling_price_paise": 6900, "product_type": "SELLABLESKU", "shelf_life_hours": 6576, "weight_in_gms": 1000, "country_of_origin": "India", "store_product_id": "3d9d18fd-fe55-557e-a694-6cc153149053", "manufacturer_name": "Unbranded", "in_stock": true, "discount_percent": 31, "max_allowed_quantity": 6, "primary_category_id": "2f7190d0-7c40-458b-b450-9a1006db3d95", "rating_average": 4.4, "mrp_paise": 10000, "description": null, "name": "BestValue Sona Masoori Raw Rice", "brand_id": "a37897a1-f7a9-48e9-bc13-f4bcb96dc6e1", "available_quantity": 6, "quantity": 14, "pack_size": 1, "l3_category_id": "3baaf8d0-e429-4b09-95bf-d6fc49a01360", "shelf_life_display": "6576 hours", "rank": 1, "brand": "BestValue", "formatted_pack_size": "1 pack (1 kg)", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1db25844-2d44-44ca-a286-7b5d802d3ca9.png", "product_variant_id": "638b44d5-ffcd-49f0-a524-634d48c8ddd6", "store_id": "b1403534-cd6b-49d0-a7cd-ce20e6497768", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1db25844-2d44-44ca-a286-7b5d802d3ca9.png" ], "is_primary": true, "super_saver": true, "product_id": "d6348e25-7990-4ffd-b715-877e0d88eeb0", "selling_price_paise": 6900, "is_active": true, "product_url": "https://www.zepto.com/pn/bestvalue-sona-masoori-raw-rice/pvid/638b44d5-ffcd-49f0-a524-634d48c8ddd6", "pricing_campaigns": [ { "price_paise": 6900, "type": "SUPER_SAVER" } ] }, { "discount_amount_paise": 8600, "unit_of_measure": "KILOGRAM", "discounted_selling_price_paise": 38400, "product_type": "SELLABLESKU", "shelf_life_hours": 17520, "weight_in_gms": 5000, "country_of_origin": "India", "store_product_id": "4bd454c3-8598-4714-a53a-33b7f8f18fc1", "manufacturer_name": "LT Foods Ltd", "in_stock": true, "discount_percent": 18, "max_allowed_quantity": 4, "primary_category_id": "2f7190d0-7c40-458b-b450-9a1006db3d95", "rating_average": 4.4, "mrp_paise": 47000, "description": "Daawat now presents the best aromatic Authentic & lightweight, Sona Masoori, rice which is sourced, from the best sona masoori growing areas of karnataka, telangana, & Andhra, such as raichur and koppal. It is aged to perfection which makes it the finest sona masoori. Daawat Sona Masoori Rice is the best way to make variety rice at home. Sona Masoori Rice has a lower calorie count than the standar…", "name": "Daawat Premium Sona Masoori Rice | Medium Grain", "brand_id": "8f0fa49a-9afe-41b5-b9bc-7fdea8af7d15", "available_quantity": 4, "quantity": 4, "pack_size": 5, "l3_category_id": "3baaf8d0-e429-4b09-95bf-d6fc49a01360", "shelf_life_display": "17520 hours", "rank": 2, "brand": "Daawat", "formatted_pack_size": "1 pack (5 kg)", "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1a14cd2a-f8d1-478a-9a3b-5fede77e0f30.jpeg", "product_variant_id": "82e8f251-f6a6-4329-afdf-5a4cfdf636ed", "store_id": "b1403534-cd6b-49d0-a7cd-ce20e6497768", "image_urls": [ "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1a14cd2a-f8d1-478a-9a3b-5fede77e0f30.jpeg" ], "is_primary": true, "primary_subcategory_id": "9798b797-0db0-4b04-b198-31b0a5849318", "super_saver": true, "badges": [ { "name": "Sponsored", "type": "SPONSORED" } ], "product_id": "be47c97a-7abc-40d8-9a40-c6fe64026c3d", "selling_price_paise": 38400, "is_active": true, "product_url": "https://www.zepto.com/pn/daawat-premium-sona-masoori-rice-medium-grain/pvid/82e8f251-f6a6-4329-afdf-5a4cfdf636ed", "pricing_campaigns": [ { "price_paise": 38400, "type": "SUPER_SAVER" } ] } ] } ] } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `captured_at` | `string` | 2026-09-24T09:56:09.12695688Z | | `query` | `string` | rice | | `results` | `array` | 2 items | | `results` | `array` | 2 items | ## 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)