Skip to content
Menu

REWALTO / DOCS / API / BLINKIT

Blinkit sponsored ads data API reference

GET /v1/data/sponsored-share with retailer=blinkit returns one record per brand, search term, pin code and day Rewalto searched Blinkit: the product cards the brand held, how many Blinkit marked sponsored, and the brand's share of all the sponsored cards. Rewalto holds about 22,21,498 Blinkit sponsored share records, for days from 23 Sept 2026 to 4 Nov 2026. It needs an API key and costs 1 credit per 10 readings; the sample record below is free.

Last updated 4 Nov 2026.

Key facts

EndpointGET /v1/data/sponsored-share
App filterretailer=blinkit
Cost1 credit per 10 readingsOnly delivered records use credits
KeyAPI key needed
Records heldabout 22,21,498, 23 Sept 2026 to 4 Nov 2026From the coverage matrix

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=blinkit&searchTerm=face%20serum&pincode=400013&limit=20"

Parameters

NameInRequiredTypeWhat it meansExample
retailerqueryyesstringThe retailer (a key from /v1/data/retailers). Use blinkit for Blinkit."blinkit"
brandquerynostringOnly this brand (exact match, case-sensitive)."Mamaearth"
searchTermquerynostringOnly this search term (exact)."shampoo"
pincodequerynostringOnly this six-digit pin code."560034"
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."blinkit"
searchTermstringThe search term."shampoo"
pincodestringThe six-digit pin code searched at."560034"
brandstringThe brand on the card, as the retailer wrote it; empty when the card named none."Dove"
slotsintegerProduct cards of this brand in the replies read.24
adAwareSlotsintegerOf those, cards from a reading that can see the ad marker.24
sponsoredSlotsintegerOf the ad-aware cards, those marked sponsored.6
organicSlotsintegerOf the ad-aware cards, those the retailer itself states are organic (Tata 1mg only); 0 elsewhere.0
top10AdAwareSlotsintegerAd-aware cards in places 1 to 10 of a reply page.8
top10SponsoredSlotsintegerSponsored cards in places 1 to 10 of a reply page.3
termAdAwareSlotsintegerAd-aware cards of every brand for this term, pin and day.410
termSponsoredSlotsintegerSponsored cards of every brand for this term, pin and day.52
sponsoredRatenull or numbersponsoredSlots / adAwareSlots: how much of this brand’s shelf was bought; null when no card was ad-aware.0.25
shareOfSponsorednull or numbersponsoredSlots / termSponsoredSlots: this brand’s share of the bought slots of the term, pin and day; null when the term had no sponsored card.0.1154
pagesintegerReply pages that carried this brand.4
firstSeenstring (date-time)The first reading that day."2026-10-21T02:31:10.000000Z"
lastSeenstring (date-time)The last reading that day."2026-10-21T14:02:44.000000Z"

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 readings. Every account gets 1,000 free credits a month, and a read that delivers nothing costs nothing.

A real Blinkit 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": "blinkit",
  "searchTerm": "face serum",
  "pincode": "400013",
  "brand": "WishCare",
  "slots": 2,
  "adAwareSlots": 2,
  "sponsoredSlots": 0,
  "organicSlots": 0,
  "top10AdAwareSlots": 2,
  "top10SponsoredSlots": 0,
  "termAdAwareSlots": 72,
  "termSponsoredSlots": 36,
  "sponsoredRate": 0,
  "shareOfSponsored": 0,
  "pages": 2,
  "firstSeen": "2026-10-29T01:04:12.000000Z",
  "lastSeen": "2026-10-29T18:19:37.000000Z"
}