latestOpenAPI 3.0.0Apache License 2.02026-07-263171,5614.1 MB

815a5b6dbaa6

Catalog Items v2022-04-01

searchCatalogItems

Search for a list of Amazon catalog items and item-related information. You can search by identifier or by keywords.

Usage Plan:

Rate (requests per second)Burst
22

The x-amzn-RateLimit-Limit response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits.

❗️ To view the response

The response to this operation cannot be displayed in this reference because of technical issues. For this operation's response schema, refer to searchCatalogItems.

get/catalog/2022-04-01/items

Query parameters

identifiersstring[]

A comma-delimited list of product identifiers that you can use to search the Amazon catalog. Note: You cannot include identifiers and keywords in the same request.

identifiersType'ASIN' | 'EAN' | 'GTIN' | 'ISBN' | 'JAN' | 'MINSAN' | 'SKU' | 'UPC'

The type of product identifiers that you can use to search the Amazon catalog. Note: identifiersType is required when identifiers is in the request.

marketplaceIdsstring[] required

A comma-delimited list of Amazon marketplace identifiers. To find the ID for your marketplace, refer to Marketplace IDs.

includedDatastring[]

A comma-delimited list of datasets to include in the response.

localestring

The locale for which you want to retrieve localized summaries. Defaults to the primary locale of the marketplace.

sellerIdstring

A selling partner identifier, such as a seller account or vendor code. Note: Required when identifiersType is SKU.

keywordsstring[]

A comma-delimited list of keywords that you can use to search the Amazon catalog. Note: You cannot include keywords and identifiers in the same request.

brandNamesstring[]

A comma-delimited list of brand names that you can use to limit the search in queries based on keywords. Note: Cannot be used with identifiers.

classificationIdsstring[]

A comma-delimited list of classification identifiers that you can use to limit the search in queries based on keywords. Note: Cannot be used with identifiers.

pageSizeinteger

The number of results to include on each page.

pageTokenstring

A token that you can use to fetch a specific page when there are multiple pages of results.

keywordsLocalestring

The language of the keywords that are included in queries based on keywords. Defaults to the primary locale of the marketplace. Note: Cannot be used with identifiers.

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.