BigBasket API

The price, MRP, unit price and stock of any bigbasket product at any Indian PIN code

bigbasket's catalogue, prices and stock depend on the delivery PIN code, so every call takes one 6-digit PIN code and answers for it.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a BigBasket endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
B
/bigbasket/v1

4 active endpoints. Every call is 3 credits.

  • POST/bigbasket/v1/search
  • POST/bigbasket/v1/product
  • POST/bigbasket/v1/pincode
  • POST/bigbasket/v1/categories

What BigBasket endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

4 endpoints

search

3 cr

Search bigbasket AS SEEN FROM ONE PIN CODE (a search term, or a category / brand page).

required
pincode
optional
query, category, brand, price_band, discount_band, min_rating, sort, page

product

3 cr

One bigbasket product at one PIN code, by the product_id a search row returns (or its bigbask…

required
pincode, product_id
optional
—

pincode

3 cr

Whether bigbasket delivers to a PIN code and how.

required
pincode
optional
—

categories

3 cr

bigbasket's category tree (top level > sub > leaf) with slugs for search.category.

required
—
optional
—

Every parameter, every allowed value →

BigBasket API

4 of 4 endpoints, ready to run

View docs ↗

Atta prices in Mumbai

3 credits1 required · 1 optional
POST/bigbasket/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the BigBasket API works

BigBasket is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 491 engines.

02
Call
POST /bigbasket/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
3 credit per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a PIN code to a priced grocery basket

Check that bigbasket delivers, search with that PIN code, then read the product pages that matter.

01pincode?pincode=400020
GET/bigbasket/v1/pincode?pincode=400020

Where the PIN code resolves, which bigbasket services are live there, and the next delivery promise.

02search?query=atta&pincode=400020
GET/bigbasket/v1/search?query=atta&pincode=400020

Products with price, MRP, discount, unit price, pack sizes, stock and category, plus bigbasket's own total.

03product?product_id=126903&pincode=400020
GET/bigbasket/v1/product?product_id=126903&pincode=400020

The product page: description, ingredients, nutrition, storage and manufacturer information, and every pack size with its own price and stock.

A PIN-code-specific grocery price and stock feed with unit prices, pack sizes and product facts.

request
curl -X POST https://api.reefapi.com/bigbasket/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"atta","pincode":"400020"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "bigbasket",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What a bigbasket field actually contains

Fields that read differently from how they look. Every row was measured against live bigbasket responses on 2026-10-14.

FieldWhat it holds
pincodeThe 6-digit PIN code the answer is for. bigbasket has no PIN-free shelf: "atta" matched 188 products at 400020 (Mumbai), 158 at 560001 (Bengaluru) and 245 at 110001 (Delhi), and the same 5 kg Aashirvaad atta cost 263.5 rupees at 400020 against 273.59 on bigbasket's default Bengaluru shelf.
price, mrp, discount_percentSelling price and maximum retail price in rupees; discount_percent is computed from the two. On 82 of 82 rows where bigbasket prints "NN% OFF" the computed figure agreed within one point. The search row and the product page agreed on price, MRP, unit price, stock and pack size for 10 of 10 products.
unit_price, unit_price_consistentbigbasket's own price per 100 g, 100 ml or piece, as published. unit_price_consistent checks it against price divided by pack size: 127 of 144 rows agreed, 3 did not (one 5 kg pack carried 6,560 per 100 g instead of 6.56), 14 could not be checked. The published value is never altered.
ean, ean_code_rawbigbasket's barcode field often holds the product's own id instead of a barcode (71 of 144 rows). ean is filled only with a valid GTIN (62 of 144 rows); the raw value is kept in ean_code_raw.
in_stock, buttonWhether the product can be added at that PIN code. Out-of-stock products still show their shelf price and the button "Notify Me"; 100 of 643 rows read were out of stock.
other_packsThe other pack sizes of the same product with their own price, MRP, unit price and stock, for example 1 kg, 2 kg, 5 kg and 10 kg of one atta.
substituted_resultstrue when bigbasket found nothing for the search term and filled the page with its own suggestions; those rows do not match the query.

Once the PIN code is fixed the answer does not depend on where the request comes from: five separate reads in the same minute returned the same 12 products with identical prices, MRPs, stock and store.

bigbasket coverage, measured

Every number below was read from live bigbasket responses on 2026-10-14, in two runs of 60 calls plus a 144-row field check across 8 searches.

Catalogue

Groceries, fresh produce, meat, dairy, household, personal care and more: 16 top-level categories; "foodgrains, oil & masala" alone listed 2,524 products at PIN code 400020.

Filters that bite

"atta" at 400020, 188 products: brand 13, price band 51-100 rupees 102, discount over 25 percent 39, rating 4 and up 108. "biscuits", 406: brand 55, price band 179, discount 111, rating 253.

Field fill

On 144 search rows: id, name, brand, pack size, price, MRP, discount, unit price, stock, category and image 144/144; rating 116; other pack sizes 74; valid EAN 62; shelf offer label 41.

Price accuracy

Search row and product page agreed on price, MRP, unit price, stock and pack size for 10 of 10 products; the computed discount matched bigbasket's "% OFF" label on 82 of 82 rows.

PIN code matters

"atta": 188 products at 400020, 158 at 560001, 245 at 110001. Five separate reads of one PIN code in the same minute: identical prices.

Limits

One PIN code per call; page size set by bigbasket (20 to 48); the price band matches the product family, so some shown packs fall outside it (counted); no review text; no member-only prices.

What people build with BigBasket

The jobs this data is most often used for.

4

endpoints

3

credits per call

01

Track grocery prices, MRP and discounts across Indian cities by PIN code.

02

Compare price per 100 g or per litre across brands and pack sizes.

03

Monitor which products are out of stock at a given PIN code.

04

Check whether bigbasket and its quick delivery serve a PIN code, and the promised delivery time.

What BigBasket data costs

The cheapest call here is 3 credits, so $15/mo (Pro) buys 3,333 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 491 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/bigbasket/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"atta","pincode":"400020"}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/bigbasket/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "atta",
  "pincode": "400020"
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up BigBasket.

Get a free key →
Do I need a bigbasket account?▾

No. Everything is read logged out: the prices, stock and delivery promise are the ones bigbasket shows any visitor who entered that PIN code. Member-only prices are not shown to a logged-out visitor, so they are not returned.

Why is pincode required?▾

Because bigbasket's catalogue, prices and stock change with the PIN code. Without one bigbasket shows a default Bengaluru shelf; the API never does that silently and echoes the place the PIN code resolved to.

Which filters are there, and do they work?▾

Each was checked against the unfiltered count in the same run at 400020. "atta" (188 products): brand aashirvaad 13, price band 51 to 100 rupees 102, discount over 25 percent 39, rating 4 and up 108. "biscuits" (406): brand britannia 55, price band 179, discount 111, rating 253.

Is the price band exact?▾

No. bigbasket matches the price band against the whole product family, so a product whose shown pack is outside the band can appear because another pack size is inside it. Each answer counts those rows in rows_outside_price_filter.

How many products per page?▾

bigbasket decides: 20 per search page at the Mumbai and Delhi stores we read, 40 on its default shelf, 48 on category and brand pages. Use page up to last_page; a page after the last returns no rows.

What happens with a misspelled search term?▾

Sometimes bigbasket answers with its own suggestions instead of an empty page. The answer then says substituted_results: true and names what bigbasket substituted, so those rows are never mistaken for matches.

Do you return reviews?▾

Rating average, rating count and review count, yes. Review text, no: it is not on the pages bigbasket serves to a logged-out visitor.

How fresh is the data?▾

Every call reads bigbasket live; nothing is cached. A search took 5.3 seconds at the median and a product 5.5 seconds in our first run.

What is the BigBasket API?▾

BigBasket API is a ReefAPI endpoint group for grocery prices, mrp, discounts, unit prices, pack sizes and stock from bigbasket for any indian pin code. It returns live JSON through POST requests under /bigbasket/v1.

Is the BigBasket API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. BigBasket calls use the same shared credit balance as every other ReefAPI engine.

Do I need a BigBasket login or account?▾

No login to BigBasket is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the BigBasket data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the BigBasket API use?▾

BigBasket actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call BigBasket from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call bigbasket actions with the same key, credit pool and JSON envelope used by normal REST requests.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 490 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-14.