Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-149189107.8 KB

Returns available facet values for filtering listings, such as categories, pricing models, fulfillment option types, publishers, and customer ratings. Each facet value includes a count of matching listings.

post/2026-02-05/searchFacets

Request body

searchTextstring

The search query text to filter listings before retrieving facets.

facetTypesSearchFacetType[]

A list of specific facet types to retrieve. If empty or null, all available facets are returned.

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.

listingFacetsobject required

A map of facet types to their corresponding facet values. Each facet value includes a display name, internal value, and count of matching listings.

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.