Flipkart Search API Documentation Search Flipkart, the largest online marketplace in India, or browse a category by store id. Filter by brand and price range and sort by relevance, popularity, price or newest. Every item has the sale price and the list price (MRP) as numbers in rupees, the discount percent, brand, rating with count, stock state, key specs and full size photos. The answer also holds the total, the page count, the filter facets with counts, the category breadcrumbs and the categories a broad search falls into (use their category value as the category parameter). A page holds up to 24 items (40 for fashion); sponsored cards are removed, so a page can hold fewer. Flipkart sometimes lists cards outside a price range or without a price; Scrappa drops them, so a page with a price range can hold fewer items, and pagination.per_page is the real count. Every returned item matches your brand and price filters; an unknown brand returns 422. The id of an item works unchanged in the product, offers, delivery and reviews endpoints. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
7 optional filters available.
string
Optional
Search words, for example iphone. Send a query, a category or both.
coffee shops
string
Optional
Flipkart store id (sid) from the breadcrumbs of a search result, for example tyy,4io for Mobiles. Send a query, a category or both.
example
string
Optional
Brand name as the brand facet shows it, for example Nike. Flipkart applies a brand only when the search falls into one category: for a broad search send a category from data.categories. Every returned item has this brand; an unknown brand returns 422.
example
integer
Optional
Lowest price in rupees. Every returned item costs at least this much.
10
integer
Optional
Highest price in rupees. Every returned item costs at most this much.
10
string
Optional
relevance (default), popularity, price_asc, price_desc or recency_desc.
relevance
integer
Optional
Page number, 1 to 100. A page past the last page returns an empty list, never the first page.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"sort": "price_asc",
"items": [
{
"id": "MOBEXRGVPHW9QZ2S",
"url": "https://www.flipkart.com/apple-iphone-8-space-grey-64-gb/p/itmexrgvkkvhjhuk?pid=MOBEXRGVPHW9QZ2S",
"brand": "Apple",
"price": 39900,
"title": "Apple iPhone 8 (Space Grey, 64 GB)",
"images": [
"https://rukminim1.flixcart.com/image/1500/1500/j7ksia80/mobile/z/2/s/apple-iphone-8-mq6k2hn-a-original-imaexsbztghyprcg.jpeg?q=70",
"https://rukminim1.flixcart.com/image/1500/1500/j7ksia80/mobile/e/w/v/apple-iphone-8-mq7f2hn-a-original-imaexsbza3tjzcxf.jpeg?q=70"
],
"rating": {
"count": 10993,
"score": 4.5,
"review_count": 776
},
"category": "Handset",
"currency": "INR",
"in_stock": false,
"subtitle": null,
"key_specs": [
"64 GB ROM",
"11.94 cm (4.7 inch) Retina HD Display",
"12MP Rear Camera | 7MP Front Camera",
"A11 Bionic Chip with 64-bit Architecture, Neural Engine, Embedded M11 Motion Coprocessor Processor",
"iOS 13 Compatible"
],
"listing_id": "LSTMOBEXRGVPHW9QZ2SXQ2WFU",
"availability": "Currently unavailable",
"original_price": 39900,
"discount_percent": null
},
{
"id": "MOBFWQ6BTFFJKGKE",
"url": "https://www.flipkart.com/apple-iphone-11-purple-64-gb/p/itm2b8d03427ddac?pid=MOBFWQ6BTFFJKGKE",
"brand": "Apple",
"price": 43900,
"title": "Apple iPhone 11 (Purple, 64 GB)",
"images": [
"https://rukminim1.flixcart.com/image/1500/1500/k2jbyq80pkrrdj/mobile-refurbished/y/k/z/iphone-11-64-a-mwlx2hn-a-apple-0-original-imafkg24ymsjav9h.jpeg?q=70",
"https://rukminim1.flixcart.com/image/1500/1500/kgiaykw0/mobile/g/k/e/apple-iphone-11-mhdf3hn-a-original-imafwqepygpnkgez.jpeg?q=70"
],
"rating": {
"count": 179698,
"score": 4.6,
"review_count": 10643
},
"category": "Handset",
"currency": "INR",
"in_stock": false,
"subtitle": null,
"key_specs": [
"64 GB ROM",
"15.49 cm (6.1 inch) Liquid Retina HD Display",
"12MP + 12MP | 12MP Front Camera",
"A13 Bionic Chip Processor"
],
"listing_id": "LSTMOBFWQ6BTFFJKGKEPHMT2V",
"availability": "Currently unavailable",
"original_price": 43900,
"discount_percent": null
}
],
"facets": [
{
"id": "internal_storage",
"title": "Internal Storage",
"values": [
{
"count": 183,
"value": "256 GB & Above",
"selected": false
},
{
"count": 66,
"value": "128 - 255.9 GB",
"selected": false
},
{
"count": 30,
"value": "64 - 127.9 GB",
"selected": false
}
]
},
{
"id": "brand",
"title": "Brand",
"values": [
{
"count": 429,
"value": "Apple",
"selected": false
}
]
}
],
"filters": {
"brand": null,
"query": "iphone",
"category": null,
"max_price": null,
"min_price": null
},
"currency": "INR",
"categories": [
{
"title": "Watches",
"total": 69192,
"category": "r18",
"children": [
{
"title": "Wrist Watches",
"total": 38551,
"category": "f13",
"children": []
}
]
}
],
"pagination": {
"total": 429,
"has_more": true,
"per_page": 24,
"total_pages": 18,
"current_page": 1
},
"breadcrumbs": [
{
"title": "Mobiles & Accessories",
"category": "tyy"
},
{
"title": "Mobiles",
"category": "tyy,4io"
}
],
"sponsored_removed": 0
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"Send a query, a category (store id) or both."
]
},
"message": "The request validation failed"
}Unknown Brand
Flipkart ignores a brand it does not know and answers the unfiltered list. Scrappa never returns that list and answers 422 instead. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "INVALID_REQUEST",
"message": "Flipkart has no products of this brand for this search. Send the brand as the brand facet of an unfiltered search shows it."
},
"success": false
}Upstream Unavailable
Flipkart did not answer or sent data Scrappa cannot read. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "upstream_unavailable",
"message": "Flipkart is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.