Flipkart Commerce API · Endpoint
Flipkart Commerce Listings Search API
Search Flipkart by keyword and get each listing's title, brand, price, MRP, discount, rating, review count and whether it is sponsored, with sort, price and brand filters.
- 1 credit per call
- Failed calls are free
- Updated
- flipkart.search.listings
Response
completed
{ "end_page": 1, "has_more": true, "start_page": 1, "filters_applied": [ "facets.price_range.from=1000,facets.price_range.to=2000", "facets.brand[]=boAt" ], "listings": [ { "title": "boAt Rockerz 110 with 40 HRS Playback, ENx Technology, Beast Mode & ASAP Charge Bluetooth", "price": 1000, "mrp": 2490, "rating": 4.2, "review_count": 6285, "assured": true, "brand": "boAt", "currency": "INR", "discount_percent": 60, "is_sponsored": false, "listing_id": "LSTACCGS9ZM78FCXJQHQEB3WE", "page": 1, "position": 1, "product_id": "ACCGS9ZM78FCXJQH", "rating_count": 111516, "url": "https://www.flipkart.com/boat-rockerz-110-40-hrs-playback-enx-technology-beast-mode-asap-charge-bluetooth/p/itmbe0acd8f09dfb?pid=ACCGS9ZM78…" }, { "title": "boAt Rockerz 255 Pro+, 60H Battery, ASAP Charge, App Support Bluetooth", "price": 1250, "mrp": 3990, "rating": 4.2, "review_count": 34895, "assured": false, "brand": "boAt", "currency": "INR", "discount_percent": 69, "is_sponsored": false, "listing_id": "LSTACCFZ95M5JTZQH3FEO8MXG", "page": 1, "position": 2, "product_id": "ACCFZ95M5JTZQH3F", "rating_count": 517854, "url": "https://www.flipkart.com/boat-rockerz-255-pro-60h-battery-asap-charge-app-support-bluetooth/p/itmd77038e81de30?pid=ACCFZ95M5JTZQH3F" } ]}
| # | Title | Brand | Price | MRP | Discount % | Rating | Reviews | Product ID | Assured | Currency |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | boAt Rockerz 110 with 40 HRS Playback, ENx Technology, Beast Mo… | boAt | 1000 | 2490 | 60 | 4.2 | 6285 | ACCGS9ZM78FCXJQH | true | INR |
| 2 | boAt Rockerz 255 Pro+, 60H Battery, ASAP Charge, App Support Bl… | boAt | 1250 | 3990 | 69 | 4.2 | 34,895 | ACCFZ95M5JTZQH3F | false | INR |
| 3 | boAt Airdopes Alpha,35H Battery, 13mm Drivers,ENx, App Support … | boAt | 1000 | 3490 | 71 | 4 | 41,871 | ACCGP2HJA3HKHTF4 | false | INR |
| 4 | boAt Rockerz 110 with 40 HRS Playback, ENx Technology, Beast Mo… | boAt | 1000 | 2490 | 60 | 4.2 | 6285 | ACCGS9ZMAXHZFU2K | true | INR |
| 5 | boAt Rockerz 412, 60H Battery,40ms Latency,ENx, App Support Blu… | boAt | 1299 | 2999 | 57 | 4 | 1617 | ACCHCJW3ENYUPQAA | true | INR |
| 6 | boAt Rockerz 301 ANC,13mm Drivers,Hall Switch, ~30dB ANC, App S… | boAt | 1399 | 3490 | 60 | 4 | 621 | ACCHEYBVRMV9REQC | true | INR |
| 7 | boAt Rockerz 200, 60H Battery, Signature Sound, ENX Tech, Dual … | boAt | 1213 | 2490 | 51 | 3.7 | 16 | ACCHKMZKWNEANYTW | false | INR |
| 8 | boAt Airdopes Alpha,35H Battery, 13mm Drivers,ENx, App Support … | boAt | 1299 | 3490 | 63 | 4 | 3645 | ACCH9K5BHNFZQGFZ | false | INR |
| 9 | boAt Rockerz Trinity Gen2,150H Battery,Hi-Res Audio LDAC,Stream… | boAt | 1499 | 3290 | 54 | 4 | 5274 | ACCHDYCGHPEDT9UY | false | INR |
| 10 | boAt Airdopes Stride,50H Battery,Quad Mic,ENx, BEAST Mode,Spati… | boAt | 1399 | 4599 | 70 | 3.7 | 52 | ACCHZEFEUNBJFHUY | false | INR |
Input
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | What to search for, as a shopper would type it. | bluetooth headphones |
| filters | array<string> | no | Filters from the categories endpoint, such as a brand. | ["facets.brand[]=boAt"] |
| max_pages | integer | no | How many result pages to read in this call. | 1 |
| max_price | integer | no | The highest price in rupees. Flipkart applies it, so an ad can fall outside it. | 2000 |
| min_price | integer | no | The lowest price in rupees. Flipkart applies it, so an ad can fall outside it. | 1000 |
| page | integer | no | Which results page to start from, starting at 1. | |
| sort | string | no | Relevance, popularity, price low to high or high to low, newest or discount. | relevance · popularity · price_asc · price_desc… |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| listings[].title | string | The product title as Flipkart shows it. | boAt Rockerz 110 with 40 HRS Playback, ENx Technology, Beast Mo… |
| listings[].brand | string | The product's brand. | boAt |
| listings[].price | integer | The selling price, in the currency given. | 1000 |
| listings[].mrp | integer | The maximum retail price printed for the product. | 2490 |
| listings[].discount_percent | integer | The discount off the MRP, in percent. | 60 |
| listings[].rating | number | The average star rating. | 4.2 |
| listings[].review_count | integer | How many written reviews the product has. | 6285 |
| listings[].is_sponsored | boolean | Whether Flipkart marks it as sponsored. | false |
| listings[].product_id | string | Flipkart's ID for the product; the product endpoints take it. | ACCGS9ZM78FCXJQH |
| listings[].assured | boolean | Whether the product carries the Flipkart Assured badge. | true |
| listings[].currency | string | The currency code of the prices. | INR |
| listings[].listing_id | string | Flipkart's ID for one seller's listing of the product. | LSTACCGS9ZM78FCXJQHQEB3WE |
| listings[].page | integer | The results page the product appeared on. | 1 |
| listings[].position | integer | The product's place in the results, starting at 1. | 1 |
| listings[].rating_count | integer | How many ratings the product has. | 111,516 |
| listings[].url | string | The page on Flipkart. | https://www.flipkart.com/boat-rockerz-110-40-hrs-playback-enx-t… |
| end_page | integer | The last results page read in this call. | 1 |
| filters_applied | array | The filters this search used. | facets.price_range.from=1000,facets.price_range.to=2000, facets… |
| has_more | boolean | Whether more results follow. | true |
| listings | array | The products. | 40 records |
| start_page | integer | The first results page read in this call. | 1 |
REST API · MCP server
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "flipkart.search.listings", "input": { "filters": [ "facets.brand[]=boAt" ], "max_pages": 1, "max_price": 2000, "min_price": 1000, "query": "bluetooth headphones" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "flipkart.search.listings", "input": { "filters": [ "facets.brand[]=boAt" ], "max_pages": 1, "max_price": 2000, "min_price": 1000, "query": "bluetooth headphones" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "flipkart.search.listings", "input": { "filters": [ "facets.brand[]=boAt" ], "max_pages": 1, "max_price": 2000, "min_price": 1000, "query": "bluetooth headphones" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
Using Upscrape, search Flipkart for boAt bluetooth headphones between 1,000 and 2,000 rupees. Make a table of title, price, MRP, discount and rating, and mark the sponsored ones.
Flipkart Commerce
More from the Flipkart Commerce API
- Flipkart Commerce Product API1 credit
- Flipkart Commerce Category Products API1 credit
- Flipkart Commerce Product Reviews API1 credit
- Flipkart Commerce Product Offers API1 credit
- Flipkart Commerce Product Sellers API1 credit
- Flipkart Commerce Search Categories API1 credit
- Flipkart Commerce Suggestions Search API1 credit
Questions
Flipkart Commerce Listings Search API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the Flipkart Commerce Listings Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need a Flipkart Commerce login?
No. It reads public Flipkart Commerce data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds flipkart.search.listings, checks its price and runs it with the same credits as the REST API.
Get started
Your first Flipkart Commerce call is free.
Up to 100 free credits to start, no card needed.