> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Zepto Products API

> Zepto products by search, category or product URL(s): prices, MRP, stock, ratings, rank, images and product details

`POST /v1/data/zepto/products/run`

**Pricing:** $0.001 per product ($1.00 per 1,000).

Search by query, browse a category and sub-category, or fetch one or more specific product URLs.

## Ways to call it

* **Search**: set `query` (optional: `city`, `pincode`, `store_id`, `lat`, `lon`, `maxResults`)
* **Category**: set `category`, `sub_category` (optional: `city`, `pincode`, `store_id`, `lat`, `lon`, `maxResults`)
* **Brand**: set `brand` (optional: `city`, `pincode`, `store_id`, `lat`, `lon`, `maxResults`)
* **URL**: set `urls` (optional: `city`, `pincode`, `store_id`, `lat`, `lon`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**query** `string`

What to search for (e.g. milk, chocolate).

**category** `string`

Top-level category (e.g. Cold Drinks & Juices).

34 allowed values, for example `Apparel Lifestyle`, `Atta Rice Oil Dals`, `Baby Care`, `Bath Body`, `Biscuits`, `Breakfast Sauces`, `Cleaning Essentials`, `Cold Drinks Juices`, `Dairy Bread Eggs`, `Electronics Appliances`. Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**sub\_category** `string`

Sub-category within it (e.g. Soft Drinks).

428 allowed values, for example `Accessories`, `Bags Wallets`, `Boys Bottomwear`, `Boys Ethnic Wear`, `Boys Innerwear`, `Boys Swimwear`, `Boys Topwear`, `Eyewear`, `Girls Ethnic Wear`, `Girls Innerwear`. Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**brand** `string`

Brand as spelled on Zepto. Pick from the list. The brand's URL slug is accepted too.

11344 allowed values, for example `&Done` (done), `&Stirred` (stirred), `1-AL` (1-al), `10'ON Tissues` (10on-tissues), `10X` (10x), `10club`, `137 Degrees` (137-degrees), `14Th Century` (14th-century), `1868 by Tata Tea` (1868-by-tata-tea), `2 B12` (2-b12). Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**urls** `string[]`

One or more product page URLs (one per line).

**store\_id** `string`

Dark store - pick a city and pincode first.

1685 allowed values, for example `a7a8db9f-5860-4635-9e4b-8b3aba6526e4` (a7a8db9f-5860-4635-9e4b-8b3aba6526e4 (110001, New Delhi)), `a122a7fb-b822-45b5-adb5-c92ed4661980` (a122a7fb-b822-45b5-adb5-c92ed4661980 (110001, New Delhi)), `91e425f8-a2d5-49e5-9f7d-a31972d22b0b` (91e425f8-a2d5-49e5-9f7d-a31972d22b0b (110001, New Delhi)), `8976f449-6e45-493e-81d1-da0b229a63e9` (8976f449-6e45-493e-81d1-da0b229a63e9 (110001, New Delhi)), `6e87b960-71e6-414e-b6f7-55d08e324811` (6e87b960-71e6-414e-b6f7-55d08e324811 (110001, New Delhi)), `3d03e7a7-4ded-458a-9349-2978cd333ef0` (3d03e7a7-4ded-458a-9349-2978cd333ef0 (110002, New Delhi)), `73b0c599-728d-4642-a0e3-1e5b68836327` (73b0c599-728d-4642-a0e3-1e5b68836327 (110003, New Delhi)), `e1befcff-e3d0-4fce-929c-50b9b6ae296f` (e1befcff-e3d0-4fce-929c-50b9b6ae296f (110007, New Delhi)), `7e7b4df8-a5a1-4acb-9aa4-b5ecf86a6f2b` (7e7b4df8-a5a1-4acb-9aa4-b5ecf86a6f2b (110007, New Delhi)), `ded31729-9c5a-4642-ac1d-7f594c474aac` (ded31729-9c5a-4642-ac1d-7f594c474aac (110007, New Delhi)). Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**lat** `number`

Or target by coordinates: latitude (use with longitude).

Min `-90`; max `90`; use together with `lon`.

**lon** `number`

Or target by coordinates: longitude (use with latitude).

Min `-180`; max `180`; use together with `lat`.

**city** `string`

City - filters the pincode and store lists.

140 allowed values, for example `New Delhi`, `Noida`, `Faridabad`, `Gurugram`, `Rewari`, `Rohtak`, `Bahadurgarh`, `Hisar`, `Sonipat`, `Karnal`. Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**pincode** `string`

Pincode - pick a city first; filters the store list.

935 allowed values, for example `110001` (110001 (New Delhi)), `110002` (110002 (New Delhi)), `110003` (110003 (New Delhi)), `110007` (110007 (New Delhi)), `110008` (110008 (New Delhi)), `110009` (110009 (New Delhi)), `110010` (110010 (New Delhi)), `110015` (110015 (New Delhi)), `110016` (110016 (New Delhi)), `110017` (110017 (New Delhi)). Fetch the full list with `GET /v1/data/zepto/products?expand=options`.

**maxResults** `integer`

How many products to return. Use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/zepto/products/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "query": "chocolate",
    "city": "Pune",
    "pincode": "412307",
    "store_id": "9a3a478d-31f5-468f-b32a-d4324844b5b2"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/zepto/products/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "query": "chocolate",
    "city": "Pune",
    "pincode": "412307",
    "store_id": "9a3a478d-31f5-468f-b32a-d4324844b5b2"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/zepto/products/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "query": "chocolate",
  "city": "Pune",
  "pincode": "412307",
  "store_id": "9a3a478d-31f5-468f-b32a-d4324844b5b2"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one product, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `productName` | Product Name | text |
| `brand` | Brand | text |
| `variantId` | Variant ID | text |
| `productId` | Product ID | text |
| `price` | Price | currency |
| `mrp` | MRP | currency |
| `discount` | Discount % | percentage |
| `packSize` | Pack Size | text |
| `inStock` | In Stock | boolean |
| `stockCount` | Stock Count | number |
| `rating` | Rating | rating |
| `ratingCount` | Rating Count | number |
| `category` | Category | text |
| `rank` | Rank | number |
| `sponsored` | Sponsored | boolean |
| `images` | Images | array |
| `productUrl` | Product URL | url |
| `description` | Description | text |
| `countryOfOrigin` | Country of Origin | text |
| `manufacturer` | Manufacturer | text |
| `seller` | Seller | text |
| `specifications` | Specifications | object\_array |
| `storeId` | Store ID | text |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "zepto/products",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "rating": 4.6,
      "productId": "b097d68a-955a-4dc8-8ca1-f4d0cd54ed65",
      "countryOfOrigin": "India",
      "images": [
        "https://cdn.zeptonow.com/production/cms/product_variant/47ee6e80-664d-47d0-9444-5ff6ba2b4db6.png"
      ],
      "mrp": 50.0,
      "brand": "Kinder",
      "variantId": "05fd7c7b-1e8b-45ce-8fac-2630951e1b10",
      "rank": 1,
      "manufacturer": "Ferrero Ind Ferrero Ind",
      "sponsored": true,
      "seller": "Drogheria Sellers Private Limited, Unit No.1008, EFC Limited, Empire Tower, South-C Wing, 10th Floor, Reliable Tech Park, Airoli, Navi Mumbai – 400708, Mahar...",
      "inStock": true,
      "ratingCount": 50636,
      "packSize": "1 pc (20 g)",
      "description": "This Product Contain :\n  Kinder Joy Chocolate Snack With Surprise Blue 1unit x 20g",
      "stockCount": 6,
      "longitude": 73.9704,
      "category": "Sweet Cravings",
      "specifications": [
        {
          "name": "brand",
          "value": "Kinder"
        },
        {
          "name": "product type",
          "value": "Chocolate"
        }
      ],
      "latitude": 18.4958,
      "productName": "Kinder Joy Blue | Chocolate | Assorted",
      "productUrl": "https://www.zepto.com/pn/x/pvid/05fd7c7b-1e8b-45ce-8fac-2630951e1b10",
      "discount": 0.0,
      "storeId": "9a3a478d-31f5-468f-b32a-d4324844b5b2",
      "price": 50.0
    }
  ]
}
```

## Related APIs

Same record shape as [`blinkit/products`](https://docs.mindcase.co/apis/blinkit/products) and [`instamart/products`](https://docs.mindcase.co/apis/instamart/products), so the three can be compared row for row.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.