Skip to content
Menu

REWALTO / DOCS / API / ZEPTO

Zepto discount depth API reference

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.

Last updated 18 Nov 2026.

Key facts

EndpointGET /v1/data/discounts
App filterretailer=zepto
Cost1 credit per 10 recordsOnly delivered records use credits
KeyAPI 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 -H "Authorization: Bearer $REWALTO_API_KEY" \
  "https://api.rewalto.com/v1/data/discounts?retailer=zepto&brand=PATANJALI&limit=30"

Parameters

NameInRequiredTypeWhat it meansExample
retailerqueryyesstringThe retailer (a key from /v1/data/retailers). Use zepto for Zepto."blinkit"
brandquerynostringOnly this brand (exact match, case-sensitive)."Amul"
categoryquerynostringOnly this category, as the retailer wrote it."Dairy"
fromquerynostringOnly IST days on or after this day (YYYY-MM-DD)."2026-10-01"
toquerynostringOnly IST days on or before this day (YYYY-MM-DD)."2026-10-17"
limitquerynostringHow many records to return, 1 to 500. Default 100."100"
cursorquerynostringThe nextCursor of the previous page, sent back with exactly the same filters. A cursor from other filters is refused."eyJ0IjoiMjAyNi0xMC0xNFQwOToyNzowMC4wMDBaIiwiaSI6NDgyMTAzNzcsImYiOiJhYmMxMjMifQ"

Record fields

FieldTypeWhat it meansExample
daystring (date)The IST day."2026-10-21"
retailerstringThe retailer key."blinkit"
brandnull or stringThe brand as the retailer wrote it; null when none."Amul"
categorynull or stringThe category as the retailer wrote it; null when none."Dairy"
listingsintegerDistinct listings read that day.60
readingsintegerAll readings that day.180
pricedintegerReadings with a selling price and an MRP at least as high.170
discountedintegerOf those, readings priced below MRP.90
avgDiscountBpnull or integerMean discount in basis points of MRP over priced readings.1450
medianDiscountBpnull or integerMedian discount in basis points of MRP.1200
maxDiscountBpnull or integerDeepest discount in basis points of MRP.4500

Errors

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

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

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%.

{
  "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
}