Croma API

The price, bank offers and store stock of any Croma product at any Indian PIN code

Croma's selling price depends on the delivery PIN code, so search, product and availability take one 6-digit PIN code and answer for it.

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

5 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/croma/v1/search
  • POST/croma/v1/product
  • POST/croma/v1/availability
  • POST/croma/v1/stores
  • POST/croma/v1/reviews

What Croma endpoints does ReefAPI ship?

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

5 endpoints

search

3 cr

Search Croma's catalogue AS PRICED AT ONE PIN CODE.

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

product

3 cr

One Croma product at one PIN code, by the product_id a search row returns (or its croma.com URL).

required
pincode
optional
product_id

availability

3 cr

Can a product reach a PIN code, when, and from where.

required
pincode
optional
product_id, radius_km

stores

2 cr

Croma stores near a PIN code, nearest first.

required
pincode
optional
radius_km

reviews

1 cr

Customer reviews of one Croma product, newest first, 50 per page.

required
—
optional
product_id, rating, page

Every parameter, every allowed value →

Croma API

5 of 5 endpoints, ready to run

View docs ↗

iPhone 17 prices in Mumbai

3 credits1 required · 1 optional
POST/croma/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 Croma API works

Croma 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 /croma/v1/…

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

03
Pay
1 or 2 or 3 credits 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, in-stock shortlist

Search with the PIN code, read the offers on the products that matter, then see where they are in stock.

01search?query=iphone%2017&pincode=400049
GET/croma/v1/search?query=iphone%2017&pincode=400049

21 products per page with the price at that PIN code, MRP, discount, offer lines, rating and stock locations, plus Croma's own total and facet counts.

02product?product_id=317418&pincode=400049
GET/croma/v1/product?product_id=317418&pincode=400049

Price and MRP at the PIN code, every bank and card offer, EAN, specifications, variants and rating.

03availability?product_id=317418&pincode=400049
GET/croma/v1/availability?product_id=317418&pincode=400049

Home-delivery date, express-delivery date and store, and units held by each Croma store within 25 km.

A PIN-code-specific price, offer and stock feed for Croma's electronics, with store-level pickup counts.

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

What a Croma field actually contains

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

FieldWhat it holds
pincodeThe 6-digit PIN code the price is for. The same Croma 43 inch TV cost 24,990 rupees at 400049 (Mumbai), 560001 and 110001 and 21,990 at 799001 (Agartala); MRP stayed 29,000. A distant PIN code is not always cheaper: one product was 12,990 at 799001 and 12,690 at 400049.
price, price_index, price_mismatchprice is the live selling price at your PIN code, the same figure product returns (24 of 24 rows checked). price_index is the figure stored in Croma's search listing, which differed from the live price on 15 of 126 rows we checked (11.9 percent, in both directions, for example 84,999 listed against 74,490 live for one HP laptop); price_mismatch flags those rows. Croma sorts and builds its price bands from the listing figure, so with price_asc a few rows can look out of order by price.
mrp, discount_percent, discount_textMaximum retail price in rupees. discount_percent is computed from MRP and price (for example 5.86); discount_text is Croma's rounded label ("6%"). The printed price text matched the number on 20 of 20 reads, in both the lakh form "₹1,34,900" and the form "₹134,900.00".
bank_offersCard and bank offers Croma applies at payment for this product: title, bank, credit or debit card, minimum transaction and validity dates. Between 0 and 14 offers per product on the 12 products we read (11 of 12 had at least one).
stock_location_countIn how many Croma stores and warehouses the product is held across India. For the stores near one PIN code, availability gives the unit count per store; the two agreed on 32 of 32 Mumbai stores for an iPhone 17 Pro.
store_pickup[].unitsUnits a store holds for pickup right now, for example 15 at Croma Juhu and 13 at Santacruz West for one iPhone 17 Pro, across 30 of the 32 Mumbai stores within 25 km.
delivery_flagsProduct-level delivery modes from the product page. They are the same for every PIN code, including one with no Croma store nearby, so availability is the PIN-code answer.
review_count, rating_distributionreview_count is the product's true number of reviews. The star split is filled only when one page holds every review, because Croma computes it per page.

Prices do not depend on where the request comes from: four separate reads of three products at two PIN codes gave identical prices, MRPs and delivery answers.

Croma coverage, measured

Every number below was read from live Croma responses on 2026-10-14, in two runs of 64 calls each plus a three-way price check and a four-way location check.

Catalogue

Phones, laptops, TVs, appliances, audio, wearables, kitchen and more: for example 410 laptops, 419 LED TVs, 453 air conditioners and 1,172 products in mobile phones.

Filters that bite

laptop (410): brand HP 72, price band 50,001-60,000 22, discount below 20 percent 176, express delivery 43. samsung (815): mobile phones 253, Android phones 219.

Price accuracy

Search rows carry the live price: row price and MRP equalled product at the same PIN code on 24 of 24 rows across laptops, TVs and refrigerators at three PIN codes, and the product page's price and MRP on 10 of 10. Croma's own listing figure, kept as price_index, differed from the live price on 15 of 126 rows.

PIN code matters

Same TV: 24,990 rupees at 400049, 21,990 at 799001. Four separate reads per product and PIN code: 0 differences.

Store stock

Units per store for the stores within 25 km of a PIN code: 30 of 32 Mumbai stores held an iPhone 17 Pro, from 2 to 40 units each.

Limits

21 products per page; one PIN code and one product per call; price sorts and price bands follow the national price; no Croma store within 25 km of some PIN codes (799001).

What people build with Croma

The jobs this data is most often used for.

5

endpoints

1/2/3

credits per call

01

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

02

Collect the bank and card offers running on a product for price-after-offer comparisons.

03

Check whether a product is in stock at Croma stores near a PIN code, and how many units.

04

Compare Croma's prices with other Indian electronics retailers for the same model.

What Croma data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 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/croma/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone 17","pincode":"400049"}'
python
import requests

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

Have a question? We got answers.

The questions people actually ask before wiring up Croma.

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

No. Everything is read logged out: the prices, offers, delivery dates and store stock are what Croma shows any visitor who entered that PIN code.

Why is pincode required?▾

Because Croma prices change by region. The same product can be 24,990 rupees in Mumbai and 21,990 in Agartala, so the API never guesses a PIN code and echoes the one it used. A PIN code Croma does not price separately gets the national price.

Which filters are there, and do they work?▾

Each was checked against the unfiltered count in the same run. laptop (410): brand HP 72, price band 50,001-60,000 22, discount below 20 percent 176, express delivery 43. refrigerator (347): brand LG 71, home delivery 141. samsung (815): category 10 (mobile phones) 253, category 95 (Android phones) 219. headphones (631): two price bands together 252, discount 60-80 percent 159.

Is brand case-sensitive?▾

Croma's own brand filter is (HP matches, hp does not, and boAt is spelled that way). When a spelling returns nothing, the API matches it against the query's brand list and asks again with Croma's spelling, and says so in brand_resolved.

What happens when nothing matches?▾

You get 0 rows. Croma itself fills a no-match search with unrelated products (179 for a nonsense word); those are dropped and search_fallback is true. Typos are corrected by Croma and the correction is returned as spelling_suggestion.

Can I page through all results?▾

Yes. 21 products per page, up to last_page. laptop had 20 pages, the last with 11 products; pages after it are empty.

How do I check stock in a store?▾

Call stores to see the Croma stores near a PIN code (32 within 25 km of 400049, 36 of 560001, 46 of 110001), then availability with a product_id and the PIN code for units per store and the delivery dates.

How fresh is the data?▾

Every call reads Croma live; nothing is cached. In our two runs a search took 1.5 to 2.5 seconds (four calls, including the live price check), the median was 1.2 seconds for a product, 2.2 and 2.8 seconds for availability, 1.2 and 1.8 seconds for stores and 0.8 and 1.0 seconds for reviews.

What is the Croma API?▾

Croma API is a ReefAPI endpoint group for electronics prices by indian pin code, bank offers, delivery dates, per-store stock, specs and reviews from croma. It returns live JSON through POST requests under /croma/v1.

Is the Croma API free to try?▾

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

Do I need a Croma login or account?▾

No login to Croma 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 Croma 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 Croma API use?▾

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

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

Yes. Connect ReefAPI once through MCP and your assistant can call croma 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.