# Multi-location search

Run one Zepto product search across up to ten delivery locations and compare normalized local results.

- 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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | No | Maximum number of results to return. From 1 to 100. Default: `20`. |
| `locations` | `array<object>` | 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`. 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
{
  "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)
