Flipkart Search API Documentation
The Flipkart Search API returns the products Flipkart shows for a search on flipkart.com, India's online marketplace. Each result includes the product ID, title, link and image, and when Flipkart shows them, the brand, price in rupees, MRP, discount, rating with its star breakdown, key specs, offer badges, stock state, the F-Assured tag and whether the card is sponsored. The response also includes the filters Flipkart offers for the search, the category path it resolved the query into, and the pages of the results. Use it to track prices, discounts and assortment on Flipkart.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
The parameter specifies your search query, such as
iphone 15. It accepts any term or phrase you'd type in a Flipkart search, in English or in an Indian language. When Flipkart searches a closer query in place of a misspelled or unknown one,search_information.is_augmentedistrueandsearch_information.query_displayedholds the query it searched.
-
- Name
-
category_id - Required
- Optional
- Description
-
This parameter keeps the search inside a Flipkart category, given as its category path, such as
tyy,4iofor Mobiles. Category paths are returned insearch_information.categories. You can also find one in thesidparameter of a Flipkart category page URL.
Example:https://www.flipkart.com/mobiles/pr?sid=tyy,4iowheretyy,4iois the category path.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Parameter allows sorting search results by different criteria. Below is the list of available sorting options:
-
best_match- sort order based on relevance. Default popularityprice_low_to_highprice_high_to_lownew_arrivalsbest_discount- Flipkart offers it on some categories only and sorts by relevance where it does not.
-
Filters
-
- Name
-
price_min - Required
- Optional
- Description
-
This parameter sets the minimum price of the products returned, in Indian rupees, from
0to10000000. For instance,10000returns products priced at₹10,000or more.
-
- Name
-
price_max - Required
- Optional
- Description
-
This parameter sets the maximum price of the products returned, in Indian rupees, from
0to10000000. For instance,20000returns products priced at₹20,000or less. It must be greater than or equal toprice_min.
-
- Name
-
filters - Required
- Optional
- Description
-
This parameter narrows the results with the filters Flipkart offers for the search, such as a brand, a customer rating, F-Assured or a discount. Use the
filter_valueof a value in the response'sfilterssection, in the formatid:name. Separate several filters with a double pipe (||), for examplebrand:HP||rating:4★ & above. Two values of one filter return products that match either.
Note: Some filter values contain the&character. URL-encode it as%26in your request. Useprice_minandprice_maxfor a price range.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
The parameter determines the results page number, from
1to41. Flipkart shows at most 1,000 results for a search: 24 products a page on list layouts, such as phones and laptops, and 40 on grid layouts, such as clothes and shoes. A grid search therefore ends at page25, and a later page returns an error.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
flipkart_search.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?engine=flipkart_search&q=iphone+15
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "flipkart_search",
"q": "iphone 15"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_WopoJgArxHiLZbrtq2PpGeAp",
"status": "Success",
"created_at": "2026-11-12T14:45:19Z",
"request_time_taken": 3.52,
"parsing_time_taken": 0.04,
"total_time_taken": 3.56,
"request_url": "https://www.flipkart.com/search?q=iphone+15",
"html_url": "https://www.searchapi.io/api/v1/searches/search_WopoJgArxHiLZbrtq2PpGeAp.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_WopoJgArxHiLZbrtq2PpGeAp"
},
"search_parameters": {
"engine": "flipkart_search",
"q": "iphone 15"
},
"search_information": {
"query_displayed": "iphone 15",
"total_results": 403,
"categories": [
{
"name": "Mobiles & Accessories",
"category_id": "tyy",
"link": "https://www.flipkart.com/mobiles-accessories/pr?sid=tyy&marketplace=FLIPKART"
},
...
]
},
"organic_results": [
{
"position": 1,
"product_id": "MOBHQV9YR4CBTD9D",
"listing_id": "LSTMOBHQV9YR4CBTD9DPLROKI",
"item_id": "ITM3234701B0863A",
"title": "Apple iPhone 15 (Black, 128 GB)",
"brand": "Apple",
"link": "https://www.flipkart.com/apple-iphone-15-black-128-gb/p/itm3234701b0863a?pid=MOBHQV9YR4CBTD9D",
"rating": 4.6,
"reviews": 250220,
"reviews_with_text": 9891,
"reviews_histogram": {
"five_star": 194796,
"four_star": 33038,
"three_star": 7570,
"two_star": 3690,
"one_star": 11126
},
"price": "₹69,999",
"extracted_price": 69999,
"original_price": "₹74,900",
"extracted_original_price": 74900,
"discount": 4901,
"discount_percentage": 6,
"key_specs": [
"128 GB ROM",
"15.49 cm (6.1 inch) Super Retina XDR Display",
"48MP + 12MP | 12MP Front Camera",
"A16 Bionic Chip, 6 Core Processor Processor"
],
"badges": [
"Bestseller",
"Lowest price since launch",
"Upto ₹46,750 Off on Exchange"
],
"warranty": "1 year warranty for phone and 1 year warranty for in Box Accessories.",
"is_assured": true,
"availability_state": "in_stock",
"thumbnail": "https://rukminim2.flixcart.com/image/312/312/xif0q/mobile/s/p/z/-original-imahqvadjn9nthhu.jpeg?q=70",
"images": [
"https://rukminim2.flixcart.com/image/832/832/xif0q/mobile/s/p/z/-original-imahqvadjn9nthhu.jpeg?q=70",
...
]
},
...
],
"filters": [
{
"id": "network_type",
"name": "Network Type",
"type": "checkbox",
"values": [
{
"name": "5G",
"items_count": 300,
"filter_value": "network_type:5G"
},
...
]
},
...
],
"pagination": {
"current": 1,
"next": "https://www.flipkart.com/search?q=iphone+15&page=2",
"other_pages": {
"2": "https://www.flipkart.com/search?q=iphone+15&page=2",
"3": "https://www.flipkart.com/search?q=iphone+15&page=3",
"4": "https://www.flipkart.com/search?q=iphone+15&page=4",
"5": "https://www.flipkart.com/search?q=iphone+15&page=5",
"6": "https://www.flipkart.com/search?q=iphone+15&page=6",
"7": "https://www.flipkart.com/search?q=iphone+15&page=7",
"8": "https://www.flipkart.com/search?q=iphone+15&page=8",
"9": "https://www.flipkart.com/search?q=iphone+15&page=9",
"10": "https://www.flipkart.com/search?q=iphone+15&page=10"
}
}
}
Flipkart mixes sponsored products into the results, and the same sponsored products can appear on every page. They carry is_sponsored: true, so you can keep or drop them.
Filters and Sorting
https://www.searchapi.io/api/v1/search?engine=flipkart_search&filters=brand%3AHP%7C%7Cbrand%3ADELL&q=laptop&sort_by=price_low_to_high
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "flipkart_search",
"q": "laptop",
"filters": "brand:HP||brand:DELL",
"sort_by": "price_low_to_high"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_YSbe1KKB2Y7srDoUTcuLa3ni",
"status": "Success",
"created_at": "2026-11-12T14:45:19Z",
"request_time_taken": 2.11,
"parsing_time_taken": 0.01,
"total_time_taken": 2.13,
"request_url": "https://www.flipkart.com/search?q=laptop&sort=price_asc&p%5B%5D=facets.brand%255B%255D%3DHP&p%5B%5D=...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_YSbe1KKB2Y7srDoUTcuLa3ni.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_YSbe1KKB2Y7srDoUTcuLa3ni"
},
"search_parameters": {
"engine": "flipkart_search",
"q": "laptop",
"sort_by": "price_low_to_high",
"filters": "brand:HP||brand:DELL"
},
"search_information": {
"query_displayed": "laptop",
"total_results": 438,
"categories": [
{
"name": "Computers",
"category_id": "6bo",
"link": "https://www.flipkart.com/computers/pr?sid=6bo&marketplace=FLIPKART"
},
...
]
},
"organic_results": [
{
"position": 1,
"product_id": "COMH333HV7BGZN2U",
"listing_id": "LSTCOMH333HV7BGZN2USFEGBM",
"item_id": "ITMBCFCBC0AB424F",
"title": "HP G-Series MediaTek MT8183 - (4 GB/32 GB EMMC Storage/Chrome OS) 11MK G9 EE Chromebook Laptop",
"subtitle": "11.6 inch, Black, 1.34 kg",
"brand": "HP",
"link": "https://www.flipkart.com/hp-g-series-mediatek-mt8183-4-gb-32-gb-emmc-storage-chrome-os-11mk-g9-ee-ch...",
"price": "₹24,700",
"extracted_price": 24700,
"original_price": "₹39,999",
"extracted_original_price": 39999,
"discount": 15299,
"discount_percentage": 38,
"key_specs": [
"MediaTek MT8183 Processor",
"4 GB LPDDR4X RAM",
"Chrome Operating System",
"29.46 cm (11.6 inch) Display"
],
"badges": [
"Only 5 left",
"Bank Offer"
],
"warranty": "1 Year Carry-in Warranty",
"availability_state": "in_stock",
"thumbnail": "https://rukminim2.flixcart.com/image/312/312/xif0q/computer/f/f/0/11mk-g9-ee-chromebook-chromebook-l...",
"images": [
"https://rukminim2.flixcart.com/image/832/832/xif0q/computer/f/f/0/11mk-g9-ee-chromebook-chromebook-l...",
...
]
},
...
],
"filters": [
{
"id": "brand",
"name": "Brand",
"type": "checkbox",
"values": [
{
"name": "HP",
"items_count": 348,
"is_selected": true,
"filter_value": "brand:HP"
},
...
]
},
...
]
}
Category and Price Range
https://www.searchapi.io/api/v1/search?category_id=tyy%2C4io&engine=flipkart_search&price_max=20000&price_min=10000&q=phone
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "flipkart_search",
"q": "phone",
"category_id": "tyy,4io",
"price_min": "10000",
"price_max": "20000"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_UDeYwUmzE8uwLx4Zg6Zjvip8",
"status": "Success",
"created_at": "2026-11-12T14:45:19Z",
"request_time_taken": 2.14,
"parsing_time_taken": 0.02,
"total_time_taken": 2.16,
"request_url": "https://www.flipkart.com/search?q=phone&sid=tyy%2C4io&p%5B%5D=facets.price_range.from%3D10000&p%5B%5...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_UDeYwUmzE8uwLx4Zg6Zjvip8.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_UDeYwUmzE8uwLx4Zg6Zjvip8"
},
"search_parameters": {
"engine": "flipkart_search",
"q": "phone",
"category_id": "tyy,4io",
"price_min": "10000",
"price_max": "20000"
},
"search_information": {
"query_displayed": "phone",
"total_results": 2355,
"categories": [
{
"name": "Mobiles & Accessories",
"category_id": "tyy",
"link": "https://www.flipkart.com/mobiles-accessories/pr?sid=tyy&marketplace=FLIPKART"
},
...
]
},
"organic_results": [
{
"position": 1,
"product_id": "MOBHZV9WCG6FZQAA",
"listing_id": "LSTMOBHZV9WCG6FZQAA0YSKCP",
"item_id": "ITM2AD4F79FBAA1D",
"title": "Ai+ Pulse 2 (Purple, 128 GB)",
"subtitle": "6 GB RAM",
"brand": "Ai+",
"link": "https://www.flipkart.com/ai-pulse-2-purple-128-gb/p/itm2ad4f79fbaa1d?pid=MOBHZV9WCG6FZQAA",
"rating": 3.7,
"reviews": 13347,
"reviews_with_text": 1125,
"reviews_histogram": {
"five_star": 6300,
"four_star": 2283,
"three_star": 1374,
"two_star": 862,
"one_star": 2528
},
"price": "₹11,999",
"extracted_price": 11999,
"original_price": "₹15,999",
"extracted_original_price": 15999,
"discount": 4000,
"discount_percentage": 25,
"key_specs": [
"6 GB RAM | 128 GB ROM | Expandable Upto 1 TB",
"17.13 cm (6.745 inch) HD+ Display",
"50MP Rear Camera | 8MP Front Camera",
"6000 mAh Battery",
"T7250 Processor"
],
"badges": [
"Only few left",
"Upto ₹9,425 Off on Exchange"
],
"warranty": "1 Year Warranty on Handset and 6 Months Warranty on the Inbox Accessories",
"availability_state": "in_stock",
"thumbnail": "https://rukminim2.flixcart.com/image/312/312/xif0q/mobile/0/2/2/-original-imahrfy7jdqhsgbf.jpeg?q=70",
"images": [
"https://rukminim2.flixcart.com/image/832/832/xif0q/mobile/0/2/2/-original-imahrfy7jdqhsgbf.jpeg?q=70",
...
]
},
...
]
}