The Selling Partner API for Catalog Items (Catalog Items API) allows developers to retrieve comprehensive information about items in the Amazon catalog. For technical details, refer to the Catalog Items API Reference.

Key Features

1. Retrieve Detailed Item Information

The API provides rich details about items in the Amazon catalog, including:

Summarized Item Details

Attributes

Browse Classifications

Dimensions

Product Identifiers

Images

Sales Rankings

Relationships

Vendors can access additional vendor-specific details.

2. Search by Identifiers or Keywords

The API supports two main search methods:

By Identifiers: Search using identifiers like UPC or EAN (up to 20 per request).

By Keywords: Search for items in the Amazon catalog using keywords.

Regardless of the search method, the following details are available:

Item details

Associated information

Explicit retrieval by ASIN

Terminology

ASIN

The Amazon Standard Identification Number uniquely identifies an item in the Amazon catalog.

SKU

A Selling Partner-Supplied SKU identifies a seller or vendor's listing. Data from one or more selling partner listings are reconciled into items in the Amazon catalog.

Variation

Variations represent a relationship between Amazon catalog items grouped by attributes such as size or color. These relationships consist of:

Parent Item: Groups all related child items into a "variation family."

Child Items: Each distinct item, such as a specific size or color.

Example

A shirt available in multiple sizes and colors will:

Have child items for each size and color combination.

Be grouped under a parent item to create a unified product detail page on Amazon retail websites.

The Catalog Items API empowers developers to interact with Amazon's catalog efficiently, offering a structured way to retrieve and search for item information.

Tutorial

1. Retrieve details for an individual item in the Amazon catalog by its identifier (ASIN)

Get Information About a Catalog Item

To retrieve information for a specific item, use the getCatalogItem operation and pass the ASIN as a path parameter.

Request

2. Search for one or more items by ASINs or product identifiers

Search for items

Call the searchCatalogItems operation

Request

Response

{
  "numberOfResults": 3,
  "items": [
    {
      "asin": "XXXXXXXXXX",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Fred Perry",
          "color": "Wht/Brt Red/Nvy",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
          "manufacturer": "Fred Perry Men's Apparel",
          "modelNumber": "M1200",
          "packageQuantity": 1,
          "partNumber": "M1200-748",
          "size": "X-Large",
          "style": "Twin Tipped Polo Shirt-m1200",
          "websiteDisplayGroup": "apparel_display_on_website"
        }
      ]
    },
    {
      "asin": "YYYYYYYYYYY",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Universal",
          "itemClassification": "BASE_PRODUCT",
          "itemName": "Dr. Seuss' The Lorax",
          "manufacturer": "Universal",
          "modelNumber": "ALE BOOK",
          "packageQuantity": 1,
          "partNumber": "MCAD61118810D",
          "websiteDisplayGroup": "dvd_display_on_website"
        }
      ]
    },
    {
      "asin": "ZZZZZZZZZZZ",
      "summaries": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "brand": "Muck Boot",
          "itemClassification": "VARIATION_PARENT",
          "itemName": "Muck Boot Women's Muckster 2 Ankle Snow Boot, black",
          "manufacturer": "Muck Boot",
          "style": "Muckster 2 Ankle",
          "websiteDisplayGroup": "shoes_display_on_website"
        }
      ]
    }
  ]
}

Catalog Items

Key Features#

1. Retrieve Detailed Item Information#

2. Search by Identifiers or Keywords#

Terminology#

ASIN#

SKU#

Variation#

Example#

Tutorial#

1. Retrieve details for an individual item in the Amazon catalog by its identifier (ASIN)#

Get Information About a Catalog Item#

Request#

2. Search for one or more items by ASINs or product identifiers#

Search for items#

Request#

Response#

Key Features

1. Retrieve Detailed Item Information

2. Search by Identifiers or Keywords

Terminology

ASIN

SKU

Variation

Example

Tutorial

1. Retrieve details for an individual item in the Amazon catalog by its identifier (ASIN)

Get Information About a Catalog Item

Request

2. Search for one or more items by ASINs or product identifiers

Search for items

Request

Response