# Zepto discount depth API reference

Last updated 18 Nov 2026.

GET /v1/data/discounts with retailer=zepto returns one record per brand, category and day on Zepto: how many readings were priced below MRP, and the average, median and deepest discount in basis points of MRP. The discount data behind it spans 25 Aug to 18 Nov 2026 (86 days) across 18 retailers, Zepto among them; 98.6% of readings carry a price, 25 Aug to 18 Nov 2026 (catalogue entry, last updated 18 Nov 2026). It needs an API key and costs 1 credit per 10 records; the record below is a real one, read with a key.

## Key facts

| | |
| --- | --- |
| Endpoint | GET /v1/data/discounts |
| App filter | retailer=zepto |
| Cost | 1 credit per 10 records (Only delivered records use credits) |
| Key | API key needed |

## Request

GET https://api.rewalto.com/v1/data/discounts, with an API key sent as Authorization: Bearer. For one retailer: for each brand and category on an IST day, the readings with a selling price and an MRP, how many were priced below MRP, and the average, median and deepest discount in basis points of MRP. Rolled up daily from Rewalto’s own readings from 25 Aug 2026, so the festive season’s discounting can be read day by day. Newest day first, optionally one brand, one category and a day range. Catalogue entry lib_festive_discounts; one record is one brand and category on one day. Charged per record delivered at the history rate (GET /v1/catalogue/entries/{id} shows it); re-reading the same records within 7 days is free, and an empty page costs nothing. No quote is needed: meta.credits shows the rate charged and the credits left. When the credits cannot cover the page: 402 credits_exhausted and no data.

cURL:

```bash
curl -H "Authorization: Bearer $REWALTO_API_KEY" \
  "https://api.rewalto.com/v1/data/discounts?retailer=zepto&brand=PATANJALI&limit=30"
```

## Parameters

| Name | In | Required | Type | What it means | Example |
| --- | --- | --- | --- | --- | --- |
| `retailer` | query | yes | string | The retailer (a key from /v1/data/retailers). Use zepto for Zepto. | `"blinkit"` |
| `brand` | query | no | string | Only this brand (exact match, case-sensitive). | `"Amul"` |
| `category` | query | no | string | Only this category, as the retailer wrote it. | `"Dairy"` |
| `from` | query | no | string | Only IST days on or after this day (YYYY-MM-DD). | `"2026-10-01"` |
| `to` | query | no | string | Only IST days on or before this day (YYYY-MM-DD). | `"2026-10-17"` |
| `limit` | query | no | string | How many records to return, 1 to 500. Default 100. | `"100"` |
| `cursor` | query | no | string | The nextCursor of the previous page, sent back with exactly the same filters. A cursor from other filters is refused. | `"eyJ0IjoiMjAyNi0xMC0xNFQwOToyNzowMC4wMDBaIiwiaSI6NDgyMTAzNzcsImYiOiJhYmMxMjMifQ"` |

## Record fields

| Field | Type | What it means | Example |
| --- | --- | --- | --- |
| `day` | string (date) | The IST day. | `"2026-10-21"` |
| `retailer` | string | The retailer key. | `"blinkit"` |
| `brand` | null or string | The brand as the retailer wrote it; null when none. | `"Amul"` |
| `category` | null or string | The category as the retailer wrote it; null when none. | `"Dairy"` |
| `listings` | integer | Distinct listings read that day. | `60` |
| `readings` | integer | All readings that day. | `180` |
| `priced` | integer | Readings with a selling price and an MRP at least as high. | `170` |
| `discounted` | integer | Of those, readings priced below MRP. | `90` |
| `avgDiscountBp` | null or integer | Mean discount in basis points of MRP over priced readings. | `1450` |
| `medianDiscountBp` | null or integer | Median discount in basis points of MRP. | `1200` |
| `maxDiscountBp` | null or integer | Deepest discount in basis points of MRP. | `4500` |

## Errors

Errors share one shape: error.code, a retry advice and a request id.

| Status | error.code |
| --- | --- |
| 400 | `invalid_request` |
| 401 | `key_expired, key_revoked, session_expired, unauthenticated` |
| 402 | `credits_exhausted, plan_required` |
| 403 | `org_missing, scope_missing` |
| 409 | `not_for_sale` |
| 429 | `rate_limited` |
| 500 | `internal` |
| 503 | `unavailable` |

- [What to do for each error](https://rewalto.com/developers/docs/errors)

## Credit cost

1 credit per 10 records. Every account gets 1,000 free credits a month, and a read that delivers nothing costs nothing.

## A real Zepto record

One real Zepto record, from a call to GET /v1/data/discounts?retailer=zepto made 18 Nov 2026, 10:47 am IST with API contract 0.203.0. It is PATANJALI on 18 Nov 2026: 2 readings with a price, 1 of them below MRP, a median discount of 7.2% and a deepest of 14.4%.

```json
{
  "day": "2026-11-18",
  "retailer": "zepto",
  "brand": "PATANJALI",
  "category": "grocery_staples_zepto",
  "listings": 2,
  "readings": 2,
  "priced": 2,
  "discounted": 1,
  "avgDiscountBp": 720,
  "medianDiscountBp": 720,
  "maxDiscountBp": 1440
}
```

## Related

- [Zepto discount depth API overview](https://rewalto.com/developers/api/zepto/discount-depth)
- [Zepto API documentation](https://rewalto.com/developers/docs/api/zepto)
- [Full API contract (OpenAPI)](https://rewalto.com/developers/openapi.json)
- [Data catalogue for agents](https://rewalto.com/developers/catalog.json)
- [MCP server tools](https://rewalto.com/developers/mcp)
- [Quickstart: your first request](https://rewalto.com/developers/docs/quickstart)
- [Pricing and free credits](https://rewalto.com/pricing)

---

Canonical page: https://rewalto.com/developers/docs/api/zepto/discount-depth
Last content change: 2026-11-18
