Flipkart Listings Search
flipkart.search.listings
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.
At a glance
- Endpoint ID
flipkart.search.listings- Price
- 3–36 credits per call; failed calls are free
- Runs for up to
- 45 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
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));
Input
| 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
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
results[0].data
{ "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" } ]}
Fields
| 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 |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Flipkart Commerce endpoints
Something missing or unclear? Ask the team that builds the Flipkart Commerce endpoints.