Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-149189107.8 KB

Returns a list of product listings based on search criteria and filters. You can search by keyword, filter by category, pricing model, fulfillment type, and other attributes, and sort results by relevance or customer rating.

post/2026-02-05/searchListings

Request body

searchTextstring

The search query text to find relevant listings.

maxResultsinteger

The maximum number of results that are returned per call. You can use <code>nextToken</code> to get more results.

sortBy'RELEVANCE' | 'AVERAGE_CUSTOMER_RATING'

The field to sort results by. Valid values are <code>RELEVANCE</code> and <code>AVERAGE_CUSTOMER_RATING</code>.

sortOrder'DESCENDING' | 'ASCENDING'

The sort direction. Valid values are <code>DESCENDING</code> and <code>ASCENDING</code>.

nextTokenstring

If <code>nextToken</code> is returned, there are more results available. Make the call again using the returned token to retrieve the next page.

Response

Success

totalResultsinteger required

The total number of listings matching the search criteria.

nextTokenstring

If <code>nextToken</code> is returned, there are more results available. Make the call again using the returned token to retrieve the next page.