searchCatalogItems

get

https://sellingpartnerapi-na.amazon.com/catalog/2020-12-01/items

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

Usage Plan:

Rate (requests per second)	Burst
2	2

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.

Query Params

keywords

array of strings

required

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

keywords*

marketplaceIds

array of strings

required

length ≤ 1

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

marketplaceIds*

includedData

array of strings

Defaults to summaries

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

Show Details

identifiers	Identifiers associated with the item in the Amazon catalog, such as UPC and EAN identifiers.
images	Images for an item in the Amazon catalog. All image variants are provided to brand owners; a thumbnail of the "MAIN" image variant is provided otherwise.
productTypes	Product types associated with the Amazon catalog item.
salesRanks	Sales ranks of an Amazon catalog item.
summaries	Summary details of an Amazon catalog item.
variations	Variation details of an Amazon catalog item (variation relationships).
vendorDetails	Vendor details associated with an Amazon catalog item. Vendor details are available to vendors only.

includedData

brandNames

array of strings

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

brandNames

classificationIds

array of strings

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

classificationIds

pageSize

integer

≤ 20

Defaults to 10

Number of results to be returned per page.

pageToken

string

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

keywordsLocale

string

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

locale

string

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

Responses

Language

Response

Choose an example:

application/json

200Success.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.