POST /listings/v3/product/search

Summary:

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.

Description:

This call fetches listing and product information based on the request criteria (batch number and internal state). 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.

The authorization header is mandatory to access this API along with all other Flipkart Seller APIs.

In addition to the authorization header, which is required for all Flipkart REST API calls, the following table includes additional headers required by this call:

Header	Description	Required	Allowed Values
Content-Type	The MIME type of the body of the request. Must be JSON.	Yes	application/json

Input:

☰ Toggle

Request Body

Request field descriptions

The following table describes the request body parameters.

Parameter	Type	Occurrence	Description
batchNo	Number	Mandatory	Batch index for pagination. Use 0 for the first batch; increment for subsequent batches.
internalState	String	Mandatory	Filter listings by internal state. Allowed values: ACTIVE, INACTIVE, READY_FOR_ACTIVATION, ARCHIVED, INACTIVATED_BY_FLIPKART. Up to 20 per batch.
searchText	String	Optional	Optional text to filter or search listings.

Output:

☰ Toggle

Response Headers

Header	Meaning
Content-Type	application/json; charset=utf-8

Status Codes

This call may return the HTTP status codes defined in the table below.

Status	Interpretation
200	Success.
400	Bad Request
401	Client unauthorized
500	Internal Server Error

Payload Model

1. 200 OK

2. 400 Bad Request

3. 500 Internal Server Error

Response field descriptions

The following tables describe the response payload.

Field	Type	Occurrence	Description
totalListingsCount	Number	Mandatory	Total number of listings matching the internal state and search criteria.
listingData	Array	Mandatory	Array of listing objects (up to 20 per batch). Each object contains the fields below.

listingData item fields

Field	Type	Occurrence	Description
listingId	String	Mandatory	Flipkart listing identifier.
sellerId	String	Mandatory	Seller identifier.
productId	String	Mandatory	Flipkart product identifier.
sku	String	Mandatory	Seller SKU for the listing.
status	String	Mandatory	Listing status (e.g. ACTIVE, INACTIVE).
product_name	String	Mandatory	Product title.
product_image_url	String	Conditional	URL of the product image.
vertical	String	Mandatory	Product vertical.
product_description	Object	Mandatory	Nested fields: ssp (Seller Selling Price); esp (Effective Selling Price, may be null); mrp (Maximum Retail Price); dimensions — breadth, length, height (cm), weight (kg).

---