Zepto sponsored ads data API reference

Request

GET https://api.rewalto.com/v1/data/sponsored-share, with an API key sent as Authorization: Bearer. For one retailer: on each IST day, for each search term and pin code Rewalto searched, the product cards each brand held, how many were marked sponsored (in all and in places 1 to 10), and the brand’s share of all the sponsored cards of that term, pin and day. Ads are counted only from readings that can see the retailer’s ad marker (Blinkit, Zepto, Nykaa and Tata 1mg today); elsewhere the ad counts are 0 and the shares null. Observed counts, never a model. Newest day first, optionally one brand, one search term, one pin code and a day range. Catalogue entry lib_sponsored_share; one record is one brand, term, pin and day. Charged per record delivered at the dataset’s published 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/sponsored-share?retailer=zepto&searchTerm=amul%20taaza%20milk&pincode=400050&limit=20"

Parameters

Record fields

Errors

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

Credit cost

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

A real Zepto record

One record from the free samples route (GET /v1/data/samples?dataset=sponsored_share), exactly as the paid read returns it, with long lists cut to three items. Samples are at least a week old; this set holds records up to 29 Oct 2026.

{
  "day": "2026-10-29",
  "retailer": "zepto",
  "searchTerm": "amul taaza milk",
  "pincode": "400050",
  "brand": "Yoga Bar",
  "slots": 1,
  "adAwareSlots": 1,
  "sponsoredSlots": 1,
  "organicSlots": 0,
  "top10AdAwareSlots": 0,
  "top10SponsoredSlots": 0,
  "termAdAwareSlots": 24,
  "termSponsoredSlots": 24,
  "sponsoredRate": 1,
  "shareOfSponsored": 0.0417,
  "pages": 1,
  "firstSeen": "2026-10-28T23:23:12.000000Z",
  "lastSeen": "2026-10-28T23:23:12.000000Z"
}