Flipkart Search API Documentation

GET   /api/v1/search?engine=flipkart_search

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_augmented is true and search_information.query_displayed holds 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,4io for Mobiles. Category paths are returned in search_information.categories. You can also find one in the sid parameter of a Flipkart category page URL.

    Example: https://www.flipkart.com/mobiles/pr?sid=tyy,4io where tyy,4io is 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
    • popularity
    • price_low_to_high
    • price_high_to_low
    • new_arrivals
    • best_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 0 to 10000000. For instance, 10000 returns products priced at ₹10,000 or more.

  • Name
    price_max
    Required
    Optional
    Description

    This parameter sets the maximum price of the products returned, in Indian rupees, from 0 to 10000000. For instance, 20000 returns products priced at ₹20,000 or less. It must be greater than or equal to price_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_value of a value in the response's filters section, in the format id:name. Separate several filters with a double pipe (||), for example brand: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 %26 in your request. Use price_min and price_max for a price range.

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number, from 1 to 41. 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 page 25, 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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=flipkart_search&q=iphone+15
Request
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)
Response
{
  "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"
    }
  }
}
Sponsored products are included

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

Filters and Sorting
GET
https://www.searchapi.io/api/v1/search?engine=flipkart_search&filters=brand%3AHP%7C%7Cbrand%3ADELL&q=laptop&sort_by=price_low_to_high
Request
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)
Response
{
  "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

Category and Price Range
GET
https://www.searchapi.io/api/v1/search?category_id=tyy%2C4io&engine=flipkart_search&price_max=20000&price_min=10000&q=phone
Request
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)
Response
{
  "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",
        ...
      ]
    },
    ...
  ]
}