v1

latestOpenAPI 3.0.0Apache License 2.02026-07-263171,5614.1 MB
Catalog Items v2020-12-01

searchCatalogItems

Search for and return a list of Amazon catalog items and associated information.

Usage Plan:

Rate (requests per second)Burst
22

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

get/catalog/2020-12-01/items

Query parameters

keywordsstring[] required

A comma-delimited list of words or item identifiers to search the Amazon catalog for.

marketplaceIdsstring[] required

A comma-delimited list of Amazon marketplace identifiers for the request.

includedDatastring[]

A comma-delimited list of data sets to include in the response. Default: summaries.

brandNamesstring[]

A comma-delimited list of brand names to limit the search to.

classificationIdsstring[]

A comma-delimited list of classification identifiers to limit the search to.

pageSizeinteger

Number of results to be returned per page.

pageTokenstring

A token to fetch a certain page when there are multiple pages worth of results.

keywordsLocalestring

The language the keywords are provided in. Defaults to the primary locale of the marketplace.

localestring

Locale for retrieving localized summaries. Defaults to the primary locale of the marketplace.

Response

Success.

numberOfResultsinteger required

The total number of selling partner listings items found for the search criteria (only results up to the page count limit is returned per request regardless of the number found).

Note: The maximum number of items (SKUs) that can be returned and paged through is 1000.