> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape Flipkart product search

> Searches Flipkart (India) for `query` and returns `products`, each with `productId` (the FSN, e.g. MOBHQV9YCUG4ZQZK), `itemId`, `listingId`, `title`, `brand`, `price`, `originalPrice` (MRP when discounted), `discountPercent`, `currency` (INR), `rating`, `ratingCount`, `reviewCount`, `assured` (F-Assured), `sponsored`, `badge` (e.g. Bestseller), `availability` / `inStock`, `keySpecs`, `category`, `image`, `images` and `url`. Also `total` (results Flipkart reports), `totalPages` and `nextPage`. `sort` orders the results, `min_price` / `max_price` filter by price, `page` picks the first page and `max_results` collects across pages. One unit per Flipkart page read.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/flipkart-search
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /marketplace/flipkart-search:
    post:
      tags:
        - Plugins
      summary: Scrape Flipkart product search
      description: >-
        Searches Flipkart (India) for `query` and returns `products`, each with
        `productId` (the FSN, e.g. MOBHQV9YCUG4ZQZK), `itemId`, `listingId`,
        `title`, `brand`, `price`, `originalPrice` (MRP when discounted),
        `discountPercent`, `currency` (INR), `rating`, `ratingCount`,
        `reviewCount`, `assured` (F-Assured), `sponsored`, `badge` (e.g.
        Bestseller), `availability` / `inStock`, `keySpecs`, `category`,
        `image`, `images` and `url`. Also `total` (results Flipkart reports),
        `totalPages` and `nextPage`. `sort` orders the results, `min_price` /
        `max_price` filter by price, `page` picks the first page and
        `max_results` collects across pages. One unit per Flipkart page read.
      operationId: flipkart_search_marketplace_flipkart_search_post
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
            description: What to search for, e.g. 'iphone 17' or 'running shoes'.
            title: Query
          description: What to search for, e.g. 'iphone 17' or 'running shoes'.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: >-
              Result order: relevance, popularity, price_asc, price_desc,
              newest.
            default: relevance
            title: Sort
          description: 'Result order: relevance, popularity, price_asc, price_desc, newest.'
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: First Flipkart results page to read (1-100).
            default: 1
            title: Page
          description: First Flipkart results page to read (1-100).
        - name: min_price
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Lowest price in rupees (INR).
            title: Min Price
          description: Lowest price in rupees (INR).
        - name: max_price
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Highest price in rupees (INR).
            title: Max Price
          description: Highest price in rupees (INR).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages, 1-240. A page holds 24 products
              (40 in fashion grids); each page is one unit.
            default: 24
            title: Max Results
          description: >-
            Products to collect across pages, 1-240. A page holds 24 products
            (40 in fashion grids); each page is one unit.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with a `products` array.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: Flipkart found no products for this search.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Flipkart on every attempt, an unusable answer, or no
            answer in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.