docs / flipkart

Flipkart API

base /flipkart/v110 endpoints

post/flipkart/v1/search1 credit

keyword product search cards (title/price/mrp/rating/image/url), paginated

Parameter		Allowed / range	Description
q	required	—	Search keyword.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort	optional	relevance · popularity · price_asc · price_desc · recency_desc	Sort order. Common Flipkart keys; others accepted.
brand	optional	—	Filter by brand name.
min_price	optional	—	Minimum price filter (INR).
max_price	optional	—	Maximum price filter (INR).

Try in playground →

post/flipkart/v1/product1 credit

full product page facts (title/price/mrp/rating/specs/highlights/images/seller/similar)

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart product URL.
itm_id	optional	—	Flipkart item id (the itmXXXX in a /p/ URL).

Try in playground →

post/flipkart/v1/reviews1 credit

buyer reviews for a product (paginated)

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart product URL.
slug	optional	—	Product slug (the part before /p/; derived from url if omitted).
itm_id	optional	—	Flipkart item id (the itmXXXX in a /p/ URL).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort	optional	MOST_RECENT · MOST_HELPFUL · POSITIVE_FIRST · NEGATIVE_FIRST	Review ordering.

Try in playground →

post/flipkart/v1/category1 credit

category/browse listing cards from a Flipkart category URL/path

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart category URL. (category needs url OR path.)
path	optional	—	Site-relative category path (alternative to url).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/flipkart/v1/browse1 credit

alias of category

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart category URL (alias of the category action).
path	optional	—	Site-relative category path.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/flipkart/v1/similar1 credit

similar/related products from a product page reco widgets

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart product URL.
itm_id	optional	—	Flipkart item id (the itmXXXX in a /p/ URL).
product_id	optional	—	Flipkart product id (FSN) to exclude from results.

Try in playground →

post/flipkart/v1/seller1 credit

seller storefront catalog cards + seller metadata

Parameter		Allowed / range	Description
seller_id	optional	—	Flipkart seller id. (seller needs seller_id OR seller_path/url.)
seller_path	optional	—	Site-relative seller storefront path.
seller_url	optional	—	Full seller storefront URL.
product_id	optional	—	Product id for seller-of-this-product lookup.
product_url	optional	—	Product URL to resolve the seller from.
url	optional	—	Generic Flipkart URL (seller or product).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/flipkart/v1/autocomplete1 credit

search autosuggest suggestions for a partial query

Parameter		Allowed / range	Description
q	required	—	Search keyword.

Try in playground →

post/flipkart/v1/categories1 credit

top-level navigation/category links from homepage state

Try in playground →

post/flipkart/v1/variants1 credit

product variant matrix (color/storage/etc.) from product page

Parameter		Allowed / range	Description
url	optional	—	Full Flipkart product URL.
itm_id	optional	—	Flipkart item id (the itmXXXX in a /p/ URL).
product_id	optional	—	Flipkart product id (FSN).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/flipkart/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"laptop"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}