# Store catalog

Traverse a Zepto store assortment as a normalized product feed with an opaque continuation cursor.

- Platform: [Zepto](https://docs.upscrape.com/docs/platforms/zepto)
- Capability ID: `zepto.catalog`
- 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": 5,
    "max_pages": 2,
    "pincode": "560067"
  },
  "capability": "zepto.catalog"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cursor` | `string` | No | Opaque cursor returned by the previous catalog response. |
| `latitude` | `number` | No | Latitude in decimal degrees. From -90 to 90. |
| `limit` | `integer` | No | Maximum number of results to return. From 1 to 500. Default: `100`. |
| `longitude` | `number` | No | Longitude in decimal degrees. From -180 to 180. |
| `max_pages` | `integer` | No | Maximum number of result pages to fetch. From 1 to 100. Default: `20`. |
| `pincode` | `string` | No | Six-digit Indian pincode. When provided, Upscrape resolves coordinates and the Zepto delivery store automatically. |
| `store_id` | `string` | No | Store identifier. |

### Example input

```json
{
  "limit": 5,
  "max_pages": 2,
  "pincode": "560067"
}
```

## 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.101068214Z",
  "count": 5,
  "cursor": "eyJzIjowLCJwIjoxLCJvIjo1fQ",
  "has_more": true,
  "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": 4800,
      "unit_of_measure": "GRAM",
      "how_to_use": [
        "Cut open the packet, transfer the meat into a bowl, rinse briefly, and proceed to cook.\nReturn/Refund Policy: For a damaged, rotten or incorrect item you can contact us within 48 hours from the order delivery time"
      ],
      "storage_instructions": "Odor, Vacuum packaging may produce a naturally strong meat odor upon opening. To eliminate it, leave the packet open at room temperature for 2 to 3 minutes.\nStore this product at 0 to 4 degrees and consume before the use by date.  \nBlood clots may naturally occur from bone cutting during processing. \nThe red colored drip water is naturally occurring myoglobin protein found in fresh meat and seafoo…",
      "discounted_selling_price_paise": 13700,
      "product_type": "SELLABLESKU",
      "shelf_life_hours": 120,
      "weight_in_gms": 500,
      "country_of_origin": "India",
      "category_path": [
        "Meats, Fish & Eggs",
        "Chicken"
      ],
      "store_product_id": "da3bf515-92c8-4f34-b691-84f4aa213478",
      "manufacturer_name": "Relish",
      "in_stock": true,
      "discount_percent": 25,
      "max_allowed_quantity": 5,
      "rating_average": 4.2,
      "mrp_paise": 18500,
      "description": "This product is halal certified.\nTender, flavorful, and convenient. Relish chicken curry cut is expertly processed to deliver the perfect balance of taste and texture & juicyness.\nThis product serves: 2 to 3 people.",
      "name": "Relish Chicken Curry Cut Without Skin",
      "brand_id": "52316c53-6fb3-4437-b847-42c4adc58ab0",
      "available_quantity": 5,
      "quantity": 5,
      "pack_size": 450,
      "category_id": "4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3",
      "l3_category_id": "b234e4ff-b9be-48d8-9103-d2f4c55fca66",
      "shelf_life_display": "5 days",
      "rank": 1,
      "brand": "Relish",
      "formatted_pack_size": "1 pack (450 g)",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/baecf45e-ec41-407f-86e0-427fda9e4c6d.jpeg",
      "subcategory_name": "Chicken",
      "product_variant_id": "8ddd4d0f-3ea7-410b-936e-cf35ddf70b1d",
      "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/baecf45e-ec41-407f-86e0-427fda9e4c6d.jpeg"
      ],
      "is_primary": true,
      "primary_subcategory_id": "95157c69-f03e-48e5-ae2f-d947af34397f",
      "category_name": "Meats, Fish & Eggs",
      "product_id": "0c429254-2294-4eee-a1ce-a45cf4670d0b",
      "selling_price_paise": 13700,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/relish-chicken-curry-cut-without-skin/pvid/8ddd4d0f-3ea7-410b-936e-cf35ddf70b1d"
    },
    {
      "discount_amount_paise": 5800,
      "unit_of_measure": "GRAM",
      "how_to_use": [
        "Cut open the packet, transfer the meat into a bowl, rinse briefly, and proceed to cook.\nReturn/Refund Policy: For a damaged, rotten or incorrect item you can contact us within 48 hours from the order delivery time"
      ],
      "storage_instructions": "Odor, Vacuum packaging may produce a naturally strong meat odor upon opening. To eliminate it, leave the packet open at room temperature for 2 to 3 minutes.\nStore this product at 0 to 4 degrees and consume before the use by date.  \nBlood clots may naturally occur from bone cutting during processing. \nThe red colored drip water is naturally occurring myoglobin protein found in fresh meat and seafoo…",
      "discounted_selling_price_paise": 21100,
      "product_type": "SELLABLESKU",
      "shelf_life_hours": 120,
      "weight_in_gms": 500,
      "country_of_origin": "India",
      "category_path": [
        "Meats, Fish & Eggs",
        "Chicken"
      ],
      "store_product_id": "6637ffac-186f-47fe-819f-33af06fc47b9",
      "manufacturer_name": "Relish",
      "in_stock": true,
      "discount_percent": 21,
      "max_allowed_quantity": 5,
      "rating_average": 4.5,
      "mrp_paise": 26900,
      "description": "This product is halal certified.\nLean, tender, and versatile. Experience the succulent taste of our premium boneless chicken breast.\nThis product serves: 3 to 4 people.",
      "name": "Relish Chicken Breast Boneless",
      "brand_id": "52316c53-6fb3-4437-b847-42c4adc58ab0",
      "available_quantity": 5,
      "quantity": 5,
      "pack_size": 450,
      "category_id": "4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3",
      "l3_category_id": "8ed03610-26b3-46f2-a14c-a8cd5fd6c84e",
      "shelf_life_display": "5 days",
      "rank": 2,
      "brand": "Relish",
      "formatted_pack_size": "1 pack (450 g)",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/1a8f51d3-dccd-4102-8453-e87d276fa194.jpeg",
      "subcategory_name": "Chicken",
      "product_variant_id": "48fab541-c58c-4e40-8796-19cc492f1095",
      "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/1a8f51d3-dccd-4102-8453-e87d276fa194.jpeg"
      ],
      "is_primary": true,
      "primary_subcategory_id": "95157c69-f03e-48e5-ae2f-d947af34397f",
      "category_name": "Meats, Fish & Eggs",
      "product_id": "18a3d95b-7788-4158-ac08-727b0fa830e5",
      "selling_price_paise": 21100,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/relish-chicken-breast-boneless/pvid/48fab541-c58c-4e40-8796-19cc492f1095"
    },
    {
      "discount_amount_paise": 4500,
      "unit_of_measure": "GRAM",
      "how_to_use": [
        "Cut open the packet, transfer the meat into a bowl, rinse briefly, and proceed to cook.\nReturn/Refund Policy: For a damaged, rotten or incorrect item you can contact us within 48 hours from the order delivery time"
      ],
      "storage_instructions": "Odor, Vacuum packaging may produce a naturally strong meat odor upon opening. To eliminate it, leave the packet open at room temperature for 2 to 3 minutes.\nStore this product at 0 to 4 degrees and consume before the use by date.  \nBlood clots may naturally occur from bone cutting during processing. \nThe red colored drip water is naturally occurring myoglobin protein found in fresh meat and seafoo…",
      "discounted_selling_price_paise": 13000,
      "product_type": "SELLABLESKU",
      "shelf_life_hours": 120,
      "weight_in_gms": 500,
      "country_of_origin": "India",
      "category_path": [
        "Meats, Fish & Eggs",
        "Chicken"
      ],
      "store_product_id": "221f72c9-9946-4760-aab5-90571cf38c5d",
      "manufacturer_name": "Relish",
      "in_stock": true,
      "discount_percent": 25,
      "max_allowed_quantity": 5,
      "rating_average": 4.5,
      "mrp_paise": 17500,
      "description": "This product is halal certified.\nSucculent, flavorful, and perfect for curry lovers. Our premium chicken curry cut with skin adds an extra layer of taste and richness to your dishes. \nThis product serves: 2 to 3 people.",
      "name": "Relish Chicken Curry Cut With Skin",
      "brand_id": "52316c53-6fb3-4437-b847-42c4adc58ab0",
      "available_quantity": 5,
      "quantity": 5,
      "pack_size": 450,
      "category_id": "4654bd8a-fb30-4ee1-ab30-4bf581b6c6e3",
      "l3_category_id": "b234e4ff-b9be-48d8-9103-d2f4c55fca66",
      "shelf_life_display": "5 days",
      "rank": 3,
      "brand": "Relish",
      "formatted_pack_size": "1 pack (450 g)",
      "image_url": "https://cdn.zeptonow.com/production/tr:w-600,ar-1000-1000,pr-true,f-auto,q-80/cms/product_variant/3c75e6a6-e03a-4457-9f66-9412a54038df.jpeg",
      "subcategory_name": "Chicken",
      "product_variant_id": "98c2ce55-81c2-4a1d-bec1-97e74bad6a18",
      "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/3c75e6a6-e03a-4457-9f66-9412a54038df.jpeg"
      ],
      "is_primary": true,
      "primary_subcategory_id": "95157c69-f03e-48e5-ae2f-d947af34397f",
      "category_name": "Meats, Fish & Eggs",
      "product_id": "dc1ceffa-8979-4b1d-bee6-d45af2f758b5",
      "selling_price_paise": 13000,
      "is_active": true,
      "product_url": "https://www.zepto.com/pn/relish-chicken-curry-cut-with-skin/pvid/98c2ce55-81c2-4a1d-bec1-97e74bad6a18"
    }
  ]
}
```
### 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.101068214Z |
| `count` | `integer` | 5 |
| `cursor` | `string` | eyJzIjowLCJwIjoxLCJvIjo1fQ |
| `has_more` | `boolean` | true |
| `location` | `object` | 9 fields |
| `location.eta_minutes` | `integer` | 10 |
| `location.eta_serviceable` | `boolean` | true |
| `location.latitude` | `number` | 12.9967012 |
| `location.longitude` | `number` | 77.758197 |
| `location.pincode` | `string` | 560067 |
| `location.secondary_store_ids` | `array` | 1 items |
| `location.serviceable` | `boolean` | true |
| `location.store_id` | `string` | e58fff62-7695-44c2-aba0-6bc96074bc64 |
| `location.store_ids` | `array` | 2 items |
| `results` | `array` | 3 items |
| `results` | `array` | 3 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)
