catalogItems_getCatalogItem

Get Amazon's LIVE catalog data for a single ASIN — the reconciled version that shoppers see on the detail page.

readAmazon Seller (SP-API)sp.catalogItems_2022-04-01

Amazon SP-API · getCatalogItem · GET /catalog/2022-04-01/items/{asin} This returns what Amazon ACTUALLY DISPLAYS, not what the seller submitted. Amazon merges data from all sellers and its own sources, then picks the winning value for each attribute (title, images, bullets, brand, etc.). To check whether Amazon kept a seller's submission, compare data.item.attributes with listings_getListingsItem's data.attributes.

Call it

In an AI client (MCP)

tools/call
{
  "name": "catalogItems_getCatalogItem",
  "arguments": {
    "store": "myStore-US",
    "asin": "<asin>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/catalogItems_getCatalogItem \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","asin":"<asin>"}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
asinrequiredstringthe ASIN (e.g. 'B0XXXXXXXX').
includedDatastring[]List of additional data to include in response. Default: ['summaries'] (basic info only). NOT supported here: 'customerReviews' (use customerFeedback_getItemReviewTopics), 'offers' (use Product Pricing API → productPricing_getItemOffersBatch). Recommended: ['attributes', 'images', 'dimensions', 'salesRanks'] for full details. Allowed: attributes | classifications | dimensions | identifiers | images | productTypes | relationships | salesRanks | summaries | vendorDetails.attributesclassificationsdimensionsidentifiersimagesproductTypesrelationshipssalesRankssummariesvendorDetails
localestringLocale for localized content (e.g. 'en_US', 'fr_CA').

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.asin — the requested ASIN.
  • data.item — catalog item object with: - asin: Amazon Standard Identification Number - summaries: basic info (title, brand, manufacturer, etc) if includedData includes 'summaries' - attributes: detailed attributes (color, size, material, etc) if includedData includes 'attributes' - images: product images with URLs if includedData includes 'images' - dimensions: package dimensions (weight, height, width, length) if includedData includes 'dimensions' - identifiers: all product identifiers (EAN, UPC, ISBN, etc) if includedData includes 'identifiers' - productTypes: product type info if includedData includes 'productTypes' - relationships: parent/child relationships (variations) if includedData includes 'relationships' - salesRanks: sales rank by category if includedData includes 'salesRanks' - classifications: the browse-node hierarchy per marketplace if includedData includes 'classifications' — [{marketplaceId, classifications: [{displayName, classificationId, parent: {displayName, classificationId, parent: …}}]}]. Amazon retired the v0 categories operation on 2026-03-31; this is the category hierarchy (a classificationId is a browse node id). - vendorDetails: vendor-only data if includedData includes 'vendorDetails' (vendors only)

Workflow

  • 1. Use catalogItems_searchCatalogItems to find ASINs of interest. 2. For up to 20 ASINs at once use catalogItems_searchCatalogItems with identifiers + identifiersType ASIN (same per-item shape); call this tool for a single ASIN.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude