Flipkart API: Search products
Searches Flipkart products by keyword, with an optional price range and sort order. Returns current listings in site order.
Unofficial. Not affiliated with or endorsed by Flipkart.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Sort optional
sort Listing order, for example price_low_to_high.
price_low_to_high
One of
relevance,price_low_to_high,price_high_to_low,newest. Defaultrelevance.- Query, required
query Product search words, for example boAt earbuds.
boAt earbuds
- Max Price optional
max_price Maximum listed price in rupees, for example 2000.
2000
Number 0 or more.
- Min Price optional
min_price Minimum listed price in rupees, for example 500.
500
Number 0 or more.
- Max Results optional
max_results Maximum number of products to return, for example 20.
60
Whole number from 1 to 60. Default
20.
Input as JSON
{ "sort": "price_low_to_high", "query": "boAt earbuds", "max_price": 2000, "min_price": 500, "max_results": 60}Output
{ "products": [ { "price": 599, "currency": "INR", "photo_link": "https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/s/r/q/superpods-earbuds-high-bass-audio-48hrs-playtime-with-asap-original-imahnr5nayyypncn.jpeg?q=70" , "star_rating": 5, "product_link": "https://www.flipkart.com/aurabit-superpods-earbuds-high-bass-audio-48hrs-playtime-asap-charge-48-bluetooth/p/itm4bc5f6627c276?pid=ACCHNR5NYSPHPECV" , "product_name": "Aurabit SuperPods Earbuds High Bass Audio, 48Hrs Playtime With ASAP Charge-48 Bluetooth", "original_price": 2999, "discount_percent": 80, "flipkart_assured": false, "number_of_ratings": 3, "flipkart_product_id": "ACCHNR5NYSPHPECV" }, { "price": 760, "currency": "INR", "photo_link": "https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/n/d/5/-original-imahhg28ggvwdsfg.jpeg?q=70" , "star_rating": 4, "product_link": "https://www.flipkart.com/boat-airdopes-plus-311-50h-battery-enx-tech-50ms-beast-mode-asap-charge-bt-v5-3-bluetooth/p/itmf9d9107cf43d1?pid=ACCHG64RDPBAT8TZ" , "product_name": "boAt Airdopes Plus 311, 50H Battery, ENx Tech, (~50ms)BEAST Mode, ASAP Charge,BT v5.3 Bluetooth", "original_price": 3990, "discount_percent": 80, "flipkart_assured": false, "number_of_ratings": 7595, "flipkart_product_id": "ACCHG64RDPBAT8TZ" }, { "price": 799, "currency": "INR", "photo_link": "https://rukminim2.flixcart.com/image/612/612/xif0q/headphone/p/9/v/-original-imahp4ymnzkvdbsz.jpeg?q=70" , "star_rating": 3.9, "product_link": "https://www.flipkart.com/boat-airdopes-71-gen-2-tws-45h-battery-mics-enx-btv6-0-hearables-app-asap-charge-bluetooth/p/itmdf56d06b238a7?pid=ACCHMDBFB5BMQTC5" , "product_name": "boAt Airdopes 71 Gen 2 TWS, 45H Battery, 2 Mics ENx, BTv6.0,Hearables App,ASAP Charge Bluetooth", "original_price": 2490, "discount_percent": 67, "flipkart_assured": true, "number_of_ratings": 170754, "flipkart_product_id": "ACCHMDBFB5BMQTC5" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"flipkart.com/search_products","input":{"sort":"price_low_to_high","query":"boAt earbuds","max_price":2000,"min_price":500,"max_results":60}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "flipkart.com/search_products" , "input": { "sort": "price_low_to_high", "query": "boAt earbuds", "max_price": 2000, "min_price": 500, "max_results": 60 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "flipkart.com/search_products" , "input": { "sort": "price_low_to_high", "query": "boAt earbuds", "max_price": 2000, "min_price": 500, "max_results": 60 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run flipkart.com/search_products# with {"sort":"price_low_to_high","query":"boAt earbuds","max_price":2000,"min_price":500,"max_results":60}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "relevance", "price_low_to_high", "price_high_to_low", "newest" ], "type": "string", "default": "relevance", "description": "Listing order, for example price_low_to_high." }, "query": { "type": "string", "minLength": 1, "description": "Product search words, for example boAt earbuds." }, "max_price": { "type": "number", "minimum": 0, "description": "Maximum listed price in rupees, for example 2000." }, "min_price": { "type": "number", "minimum": 0, "description": "Minimum listed price in rupees, for example 500." }, "max_results": { "type": "integer", "default": 20, "maximum": 60, "minimum": 1, "description": "Maximum number of products to return, for example 20." } }}Output schema
{ "type": "object", "required": [ "products" ], "properties": { "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "price", "currency", "product_link", "flipkart_product_id", "flipkart_assured" ], "properties": { "price": { "type": "number" }, "currency": { "enum": [ "INR" ], "type": "string" }, "photo_link": { "type": [ "string", "null" ] }, "star_rating": { "type": [ "number", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "original_price": { "type": [ "number", "null" ] }, "discount_percent": { "type": [ "number", "null" ] }, "flipkart_assured": { "type": "boolean" }, "number_of_ratings": { "type": [ "integer", "null" ] }, "flipkart_product_id": { "type": "string" } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
flipkart.com/search_products- Returns
- product name, price, original price, discount, rating, ratings count, assured badge, photo, link, product id
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method flipkart.com/search_products with the inputs above.
Ask your agent
- Find wireless earbuds under 2000 rupees sorted by price low to high
- Show me the cheapest boAt earbuds on Flipkart
- Search for running shoes between 800 and 2500 rupees, newest first
- I need a list of 10 budget Bluetooth speakers ranked by relevance
- Look up Samsung phone cases priced from 300 to 900 rupees, highest price first
See more
All Flipkart methodsFinds a Flipkart product from its name or link and returns its price, offers, seller, ratings, highlights, specifications, images and delivery estimate (for a PIN code when given).
flipkart.com/get_product_by_productSearches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
aliexpress.com/search_productsSearches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
bestbuy.com/search_productsSearches Walmart products by keywords with optional sort and price range, returning prices, ratings, sellers and availability in Walmart's order. Uses Walmart's default location (no ZIP-based pricing).
walmart.com/search_productsSearches Kohl's products in site order and returns prices, offers, ratings and links for each result.
kohls.com/search_productsSearch Nordstrom products by words, price, sale status and sort order. Prices are the lowest listed price. Available sizes may be empty when a product page is unavailable.
nordstrom.com/search_productsSearches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price.
macys.com/search_productsSearches B&H Photo products by keywords, with optional price range and sort order, and returns prices, savings, stock, ratings, identifiers, images and links in site order. Exact category names fall back to phrase matching to show products.
bhphotovideo.com/search_products