Flipkart Commerce API reference

Flipkart Category Products

flipkart.category.products

Browse a category by its ID or URL and get the same listing fields as search, with sort and filters.

Flipkart Category Products API: overview and live sample

At a glance

Endpoint ID: flipkart.category.products
Price: 5–30 credits per call; failed calls are free
Runs for up to: 45 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: flipkart__category__products; Pin tools
OpenAPI: openapi.json; Download

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.category.products",  "input": {    "category_id": "0pm/fcn/821"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "flipkart.category.products",  "input": {    "category_id": "0pm/fcn/821"  }}''')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.category.products",  "input": {    "category_id": "0pm/fcn/821"  }}),});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
`category_id`	string	one of	A category ID from the categories endpoint.	0pm/fcn/821
`url`	string	one of	A Flipkart category URL, as an alternative to the ID.
`filters`	array<string>	no	Filters from the categories endpoint, such as a brand.
`max_pages`	integer	no	How many pages to read in this call.
`max_price`	integer	no	The highest price in rupees.
`min_price`	integer	no	The lowest price in rupees.
`page`	integer	no	Which page to start from, starting at 1.
`sort`	string	no	Relevance, popularity, price, 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

{  "name": "Earphones",  "end_page": 1,  "has_more": true,  "start_page": 1,  "total_products": 80601,  "breadcrumbs": [    {      "name": "Home",      "url": "https://www.flipkart.com/"    },    {      "name": "Audio & Video",      "url": "https://www.flipkart.com/audio-video/pr?sid=0pm&marketplace=FLIPKART"    }  ],  "listings": [    {      "title": "Fire-Boltt Aero Ultra TWS Earbuds, Custom EQ Profiles, 50H Battery, Quad Mic ENC, BT 5.4 Bluetooth",      "price": 899,      "mrp": 8999,      "rating": 3.8,      "review_count": 5105,      "assured": false,      "brand": "Fire-Boltt",      "currency": "INR",      "discount_percent": 90,      "is_sponsored": true,      "listing_id": "LSTACCHEY8PTHZEAFPMBEOAGR",      "page": 1,      "position": 1,      "product_id": "ACCHEY8PTHZEAFPM",      "rating_count": 27123,      "url": "https://www.flipkart.com/fire-boltt-aero-ultra-tws-earbuds-custom-eq-profiles-50h-battery-quad-mic-enc-bt-5-4-bluetooth/p/itm5fd43753f6343?…"    },    {      "title": "MOTOROLA Buds 2 Fusion with 55dB ANC,12.4mm Titanium Driver, 6 Mic ENC, 53 Hour Playback Bluetooth",      "price": 1999,      "mrp": 4999,      "rating": 4.2,      "review_count": 134,      "assured": true,      "brand": "MOTOROLA",      "currency": "INR",      "discount_percent": 60,      "is_sponsored": true,      "listing_id": "LSTACCHQET6DUMXT3TAM4ZO4F",      "page": 1,      "position": 2,      "product_id": "ACCHQET6DUMXT3TA",      "rating_count": 598,      "url": "https://www.flipkart.com/motorola-buds-2-fusion-55db-anc-12-4mm-titanium-driver-6-mic-enc-53-hour-playback-bluetooth/p/itm574bc5f6f8ac8?pid…"    }  ]}

Fields

Field	Type	What it is	Example
`listings[].title`	string	The product title as Flipkart shows it.	Fire-Boltt Aero Ultra TWS Earbuds, Custom EQ Profiles, 50H Batt…
`listings[].brand`	string	The product's brand.	Fire-Boltt
`listings[].price`	integer	The selling price, in the currency given.	899
`listings[].mrp`	integer	The maximum retail price printed for the product.	8999
`listings[].discount_percent`	integer	The discount off the MRP, in percent.	90
`listings[].rating`	number	The average star rating.	3.8
`listings[].is_sponsored`	boolean	Whether Flipkart marks it as sponsored.	true
`listings[].product_id`	string	Flipkart's ID for the product; the product endpoints take it.	ACCHEY8PTHZEAFPM
`listings[].review_count`	integer	How many written reviews the product has.	5105
`listings[].assured`	boolean	Whether the product carries the Flipkart Assured badge.	false
`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.	LSTACCHEY8PTHZEAFPMBEOAGR
`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.	27,123
`listings[].url`	string	The page on Flipkart.	https://www.flipkart.com/fire-boltt-aero-ultra-tws-earbuds-cust…
`name`	string	The name as Flipkart shows it.	Earphones
`breadcrumbs`	array	The category path above the page.	4 records
`breadcrumbs[].name`	string	The name as Flipkart shows it.	Home
`breadcrumbs[].url`	string	The page on Flipkart.	https://www.flipkart.com/
`end_page`	integer	The last results page read in this call.	1
`has_more`	boolean	Whether more results follow.	true
`listings`	array	The products.	39 records
`start_page`	integer	The first results page read in this call.	1
`total_products`	integer	How many products Flipkart says match.	80,601

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.