SP-API Catalog Items

Get catalog item

Proxy to https://developer-docs.amazon.com/sp-api/reference/getcatalogitem. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it here.

get/api/v1/sp-api/catalog/2022-04-01/items/{asin}

Request

  • Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
  • URL: https://app.sellerassistant.app/api/v1/sp-api/catalog/2022-04-01/items/{asin}
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-Api-Key

Path parameters

The Amazon Standard Identification Number (ASIN) of the item.

Query parameters

A comma-delimited list of datasets to include in the response. Allowed values: attributes, classifications, dimensions, identifiers, images, productTypes, relationships, salesRanks, summaries, vendorDetails.

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

Amazon marketplace domain. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. Options: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.es, amazon.it, amazon.fr, amazon.in, amazon.com.mx, amazon.com.br.

Amazon marketplace id. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. See all options here.

Response

Successful response

asinstring

The unique identifier of an item in the Amazon catalog.

attributesobject nullable

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.

Example response

{
  "asin": "B00U26V4VQ",
  "classifications": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "classifications": [
        {
          "displayName": "Electronics",
          "classificationId": "123456789"
        }
      ]
    }
  ],
  "dimensions": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "item": {
        "height": {
          "unit": "inches",
          "value": 10.5
        },
        "length": {
          "unit": "inches",
          "value": 10.5
        },
        "weight": {
          "unit": "inches",
          "value": 10.5
        },
        "width": {
          "unit": "inches",
          "value": 10.5
        }
      },
      "package": {
        "height": {
          "unit": "inches",
          "value": 10.5
        },
        "length": {
          "unit": "inches",
          "value": 10.5
        },
        "weight": {
          "unit": "inches",
          "value": 10.5
        },
        "width": {
          "unit": "inches",
          "value": 10.5
        }
      }
    }
  ],
  "identifiers": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "identifiers": [
        {
          "identifierType": "UPC",
          "identifier": "123456789012"
        }
      ]
    }
  ],
  "images": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "images": [
        {
          "variant": "MAIN",
          "link": "https://www.example.com/image.jpg",
          "height": 500,
          "width": 500
        }
      ]
    }
  ],
  "productTypes": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "productType": "LUGGAGE"
    }
  ],
  "relationships": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "relationships": [
        {
          "type": "VARIATION",
          "childAsins": [
            "B00U26V4VQ",
            "B08T8YZ49Z"
          ],
          "parentAsins": [
            "B08T8YZ47X"
          ],
          "variationTheme": {
            "attributes": [
              "Color",
              "Size"
            ],
            "theme": "ColorSize"
          }
        }
      ]
    }
  ],
  "salesRanks": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "classificationRanks": [
        {
          "classificationId": "123456789",
          "title": "Best Sellers in Electronics",
          "rank": 1,
          "link": "https://www.amazon.com/gp/bestsellers/electronics"
        }
      ],
      "displayGroupRanks": [
        {
          "websiteDisplayGroup": "electronics",
          "title": "Best Sellers in Electronics",
          "rank": 1,
          "link": "https://www.amazon.com/gp/bestsellers/electronics"
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brand": "Samsung",
      "browseClassification": {
        "displayName": "Electronics",
        "classificationId": "123456789"
      },
      "color": "Black",
      "contributors": [
        {
          "role": {
            "value": "author",
            "displayName": "Author"
          },
          "value": "John Smith"
        }
      ],
      "itemClassification": "BASE_PRODUCT",
      "itemName": "Samsung QLED TV",
      "manufacturer": "Samsung Electronics",
      "modelNumber": "QN82Q60RAFXZA",
      "packageQuantity": 1,
      "partNumber": "QN82Q60RAFXZA",
      "releaseDate": "2021-03-01T00:00:00Z",
      "size": "82-inch",
      "style": "Flat",
      "tradeInEligible": true,
      "websiteDisplayGroup": "electronics",
      "websiteDisplayGroupName": "Electronics"
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandCode": "SAMSUNG",
      "manufacturerCode": "SAMSUNG",
      "manufacturerCodeParent": "SAMSUNG_PARENT",
      "productCategory": {
        "displayName": "Electronics",
        "value": "50400100"
      },
      "productGroup": "Electronics",
      "productSubcategory": {
        "displayName": "Electronics",
        "value": "50400100"
      },
      "replenishmentCategory": "BASIC"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.