Search listings and product details

POST /sellers/listings/v3/product/search

Retrieve listings and product details for the specified search criteria. At a time, a maximum of 20 listings are returned per batch based on the internalState filter. Use batchNo for pagination: start with 0 for the first batch; subsequent batches use incrementing values to fetch the next set of up to 20 listings.

application/json

Request Body required

batchNo integer required
Batch index for pagination. Use 0 for the first batch; increment for subsequent batches.
internalState string required
Possible values: [ACTIVE, INACTIVE, READY_FOR_ACTIVATION, ARCHIVED, INACTIVATED_BY_FLIPKART]
Filter listings by internal state. Up to 20 listings returned per batch.
searchText string
Optional text to filter or search listings.

Responses

Successfully fetched listings.

application/json

Schema
Example (from schema)

Schema

totalListingsCount integer
Total number of listings matching the internal state and search criteria.
listingData object[]
Array of listing objects (up to 20 per batch).
Array [
listingId string
Flipkart listing identifier.
sellerId string
Seller identifier.
productId string
Flipkart product identifier.
sku string
Seller SKU for the listing.
status string
Possible values: [ACTIVE, INACTIVE]
Listing status.
product_name string
Product title.
product_image_url string
URL of the product image.
vertical string
Product vertical.
product_description object
Product description containing price and dimension details
ssp number
Seller Selling Price.
esp number
Effective Selling Price (may be null).
mrp number
Maximum Retail Price.
dimensions object
Product dimensions
breadth number
Breadth in cm.
length number
Length in cm.
height number
Height in cm.
weight number
Weight in kg.
]

{
  "totalListingsCount": "<totalListingsCount for state>",
  "listingData": [
    {
      "listingId": "<listing-id>",
      "sellerId": "<seller-id>",
      "productId": "<product-id>",
      "sku": "<sku>",
      "status": "ACTIVE|INACTIVE",
      "product_name": "<product_title>",
      "product_image_url": "<product_image_url>",
      "vertical": "<vertical>",
      "product_description": {
        "ssp": 0,
        "esp": 0,
        "mrp": 0,
        "dimensions": {
          "breadth": 0,
          "length": 0,
          "height": 0,
          "weight": 0
        }
      }
    }
  ]
}