searchCatalogItems

get https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items

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
5	5

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.

Note: Due to technical issues, the response to this operation cannot be displayed in this reference. For this operation's response schema, refer to searchCatalogItems.

Query Params

identifiers

array of strings

length ≤ 20

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.

identifiers

identifiersType

string

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

marketplaceIds

array of strings

required

length ≤ 1

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

marketplaceIds*

includedData

array of strings

Defaults to summaries

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

Show Details

attributes	A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/docs/product-type-definitions-api-v2020-09-01-reference).
classifications	Classifications (browse nodes) for an item in the Amazon catalog.
dimensions	Dimensions of an item in the Amazon catalog.
identifiers	Identifiers that are associated with the item in the Amazon catalog, such as UPC and EAN.
images	Images for an item in the Amazon catalog.
productTypes	Product types associated with the Amazon catalog item.
relationships	Relationship details of an Amazon catalog item (for example, variations).
salesRanks	Sales ranks of an Amazon catalog item.
summaries	Summary of an Amazon catalog item. For more information, refer to the `attributes` of an Amazon catalog item.
vendorDetails	Vendor details associated with an Amazon catalog item. Vendor details are only available to vendors.

includedData

locale

string

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

sellerId

string

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

keywords

array of strings

length ≤ 20

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.

keywords

brandNames

array of strings

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.

brandNames

classificationIds

array of strings

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.

classificationIds

pageSize

integer

≤ 20

Defaults to 10

The number of results to include on each page.

pageToken

string

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

keywordsLocale

string

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.

400

Request has missing or invalid parameters and cannot be parsed.

403

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

404

The resource specified does not exist.

413

The request size exceeded the maximum accepted size.

415

The request payload is in an unsupported format.

429

The frequency of requests was greater than allowed.

500

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

503

Temporary overloading or maintenance of the server.

xxxxxxxxxx
}
{
  "numberOfResults": 1,
  "pagination": {
    "nextToken": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234",
    "previousToken": "ilkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d"
  },
  "refinements": {
    "brands": [
      {
        "numberOfResults": 1,
        "brandName": "SAMSUNG"
      }
    ],
    "classifications": [
      {
        "numberOfResults": 1,
        "displayName": "Electronics",
        "classificationId": "493964"
      }
    ]
  },
  "items": [
    {
      "asin": "B07N4M94X4",
      "attributes": {

x-amzn-RateLimit-Limit	Your rate limit (requests per second) for this operation.
x-amzn-RequestId	Unique request reference identifier.

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.