Croma API & Scraper
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.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`search` returns 21 products per page for a query or a category id: the live selling price at that PIN code, MRP, discount percent, Croma's listing price with a mismatch flag, offer lines such as a bank discount or no-cost EMI, key features, brand, rating, review count, category ids and in how many Croma locations the product is stocked, with filters for category, brand, price band, discount band and express or home delivery, six sort orders and Croma's own facet counts. `product` takes the product_id from any search row and returns the price at the PIN code, the bank and card offers running on it (bank, credit or debit, minimum spend, validity), EAN, description, every specification group, images, colour and storage variants with their ids, breadcrumbs, warranty and rating. `availability` answers whether the product reaches that PIN code: the home-delivery date, the express-delivery date and the store that would ship it, and how many units each Croma store within 25 km holds for pickup. `stores` lists the stores near a PIN code and `reviews` returns the review text.
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.
| Field | What it holds |
|---|---|
| pincode | The 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_mismatch | price 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_text | Maximum 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_offers | Card 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_count | In 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[].units | Units 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_flags | Product-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_distribution | review_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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/croma/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone 17",
"pincode": "400049"
}
}{
"ok": true,
"meta": {
"api": "croma",
"endpoint": "search",
"mode": "live",
"latency_ms": 939.1,
"record_count": 21,
"bytes": 193618,
"cache_hit": false,
"pincode": "400049",
"total": 50,
"upstream_requests": 2,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "f1092732598e49f6",
"fetched_at": "2026-10-14T18:57:19.886Z"
},
"data": {
"pincode": "400049",
"query": "iphone 17",
"category": null,
"total": 50,
"page": 1,
"page_size": 21,
"last_page": 3,
"has_next": true,
"returned": 21,
"results": [
{
"product_id": "324530",
"title": "Apple iPhone 17 (256GB, Black)",
"summary": "APPLE IPHONE 17 256GB BLACK NMRP",
"brand": "Apple",
"brand_id": "b-0025",
"url": "https://www.croma.com/apple-iphone-17-256gb-black-/p/324530",
"image": "https://media.tatacroma.com/Croma%20Assets/Communication/Mobiles/Images/324530_0_NhJZbbmuv.png?updatedAt=1789115758306",
"price": 93490,
"mrp": 99900,
"discount_percent": 6.42,
"price_text": "₹93,490.00",
"mrp_text": "₹99,900.00",
"price_text_matches": true,
"price_mismatch": false,
"price_index": 93490,
"mrp_index": 99900,
"price_index_text": "₹93,490",
"price_index_text_matches": true,
"discount_text_index": "6%",
"currency": "INR",
"offer_messages": [],
"key_features": [
"Display: 6.3 inches (15.93 cm), Super Retina XDR OLED Display, 120 Hz Refresh Rate",
"Memory: 256GB ROM",
"Processor: Apple A19 Chip, Hexa Core"
],
"rating": null,
"rating_count": 0,
"review_count": 0,
"category_ids": [
"1",
"10",
"97"
],
"in_stock": true,
"stock_location_count": 403,
"standard_warranty_months": 12,
"launch_date": "2026-09-12T12:30:38",
"rank": 1
},
{
"product_id": "324465",
"title": "Apple iPhone 17 (256GB, Lavender)",
"summary": "APPLE IPHONE 17 256GB LAVENDER NMRP",
"brand": "Apple",
"brand_id": "b-0025",
"url": "https://www.croma.com/apple-iphone-17-256gb-lavender-/p/324465",
"image": "https://media.tatacroma.com/Croma%20Assets/Communication/Mobiles/Images/324465_0_dksttj-kp.png?updatedAt=1789117886758",
"price": 93490,
"mrp": 99900,
"discount_percent": 6.42,
"price_text": "₹93,490.00",
"mrp_text": "₹99,900.00",
"price_text_matches": true,
"price_mismatch": false,
"price_index": 93490,
"mrp_index": 99900,
"price_index_text": "₹93,490",
"price_index_text_matches": true,
"discount_text_index": "6%",
"currency": "INR",
"offer_messages": [],
"key_features": [
"Display: 6.3 inches (15.93 cm), Super Retina XDR OLED Display, 120 Hz Refresh Rate",
"Memory: 256GB ROM",
"Processor: Apple A19 Chip, Hexa Core"
],
"rating": null,
"rating_count": 0,
"review_count": 0,
"category_ids": [
"1",
"10",
"97"
],
"in_stock": true,
"stock_location_count": 448,
"standard_warranty_months": 12,
"launch_date": "2026-09-12T10:46:16",
"rank": 2
},
{
"product_id": "324462",
"title": "Apple iPhone 17 (256GB, Mist Blue)",
"summary": "APPLE IPHONE 17 256GB MIST BLUE NMRP",
"brand": "Apple",
"brand_id": "b-0025",
"url": "https://www.croma.com/apple-iphone-17-256gb-mist-blue-/p/324462",
"image": "https://media.tatacroma.com/Croma%20Assets/Communication/Mobiles/Images/324462_0_xw39yoB14.png?updatedAt=1789117987177",
"price": 93490,
"mrp": 99900,
"discount_percent": 6.42,
"price_text": "₹93,490.00",
"mrp_text": "₹99,900.00",
"price_text_matches": true,
"price_mismatch": true,
"price_index": 95990,
"mrp_index": 99900,
"price_index_text": "₹95,990",
"price_index_text_matches": true,
"discount_text_index": "4%",
"currency": "INR",
"offer_messages": [],
"key_features": [
"Display: 6.3 inches (15.93 cm), Super Retina XDR OLED Display, 120 Hz Refresh Rate",
"Memory: 256GB ROM",
"Processor: Apple A19 Chip, Hexa Core"
],
"rating": null,
"rating_count": 0,
"review_count": 0,
"category_ids": [
"1",
"10",
"97"
],
"in_stock": true,
"stock_location_count": 446,
"standard_warranty_months": 12,
"launch_date": "2026-09-12T10:42:57",
"rank": 3
}
],
"search_fallback": false,
"spelling_suggestion": null,
"featured_rows": 0,
"facets": {
"category": [
{
"value": "iPhones",
"count": 50,
"category_id": "97"
}
],
"price_band": [
{
"value": "30001-40000",
"count": 2,
"label": "30,001 - 40,000"
},
{
"value": "40001-50000",
"count": 1,
"label": "40,001 - 50,000"
},
{
"value": "50001-60000",
"count": 3,
"label": "50,001 - 60,000"
}
],
"discount_band": [
{
"value": "0-20",
"count": 29,
"label": "Below 20%"
}
],
"specifications": [
{
"code": "SG-M&TStorageSpecifications-InternalStorage",
"name": "Internal Storage (GB)",
"values": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
},
{
"code": "SG-ProductAesthetics-ColorFamily",
"name": "Color",
"values": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
},
{
"code": "SG-NetworkTechnology-DataGenerationSupported",
"name": "Cellular Technology",
"values": [
"[trimmed-depth]"
]
}
],
"brand": [
{
"value": "Apple",
"count": 50
}
],
"delivery_mode": [
{
"value": "express",
"count": 31,
"label": "Express Delivery"
},
{
"value": "home",
"count": 11,
"label": "Home Delivery"
}
]
},
"priced": 21,
"price_mismatch": 1,
"price_missing": 0
}
}What the Croma API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Croma's catalogue AS PRICED AT ONE PIN CODE: 21 products per page with the LIVE selling price, MRP and discount % at that PIN (from Croma's price service, the same figure `product` returns; the search index's own figure is kept as price_index and differences are flagged), offer lines (bank discount, NeuCard, no-cost EMI), key features, brand, rating, review count, category ids, whether any Croma store or warehouse holds stock and in how many locations, warranty, launch date. Filters: category, brand, price band, discount band, delivery mode (express / home); six sort orders. Returns the source's facet counts (categories with their ids, brands, price and discount bands, specification facets). `pincode` and at least one of `query` / `category` are required. | Pricing teams call search to search Croma's catalogue AS PRICED AT ONE PIN CODE. | pincode, query, category, brand, price_band, ... |
| product | One Croma product at one PIN code, by the `product_id` a search row returns (or its croma.com URL): selling price, MRP, discount (computed and the source's own), the bank / card offers running on it (bank, card type, minimum spend, validity), the product's delivery-mode flags (home, express, store pickup, cash on delivery — product-level, NOT checked against the PIN: use `availability` for that), rating, review and rating counts, and the full record — EAN, brand, description, key features, every specification group, images, videos, category breadcrumbs, colour / storage variants with their ids, current store offer notes, warranty, EMI flag. | Marketplace operators call product to get one Croma product at one PIN code, by the `product_id` a search row. | pincode, product_id |
| availability | Can a product reach a PIN code, when, and from where: the home-delivery date and the node it ships from, the express-delivery date and the Croma store that would ship it, and for every Croma store within the radius the number of units it holds for pickup (with distance and address) — plus the source's reason for each mode that is not possible. | Catalog enrichment teams call availability to get can a product reach a PIN code, when, and from where. | pincode, product_id, radius_km |
| stores | Croma stores near a PIN code, nearest first: store id (the id `availability` reports stock under), name, full address, city, state, store PIN, phone numbers, coordinates, distance, opening hours, amenities, store manager, photo. | Retail analysts call stores to get croma stores near a PIN code, nearest first. | pincode, radius_km |
| reviews | Customer reviews of one Croma product, newest first, 50 per page: star rating, text, reviewer name as shown, date, verified-purchase flag — plus the product's average rating, its true review count and (when one page holds every review) the star split. Optional filter to one star level. | Pricing teams call reviews to get customer reviews of one Croma product, newest first, 50 per page. | product_id, rating, page |
Call search from your stack
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"}'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"])const res = await fetch("https://api.reefapi.com/croma/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone 17",
"pincode": "400049"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.croma.search with {"query":"iphone 17","pincode":"400049"}.Who uses this API and why
- Track electronics prices, MRP and discounts across Indian cities by PIN code.
- Collect the bank and card offers running on a product for price-after-offer comparisons.
- Check whether a product is in stock at Croma stores near a PIN code, and how many units.
- Compare Croma's prices with other Indian electronics retailers for the same model.
- Build a product catalogue with EAN, brand, full specifications, variants and images.
Questions developers ask before integrating
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.