getCatalogItem

检索亚马逊目录中项目的详细信息。

使用计划：

速率（每秒请求数）	突发
2	2

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如适用）。上表指示了此操作的默认速率和突发值。由于商业需求需要更高吞吐量的销售合作伙伴，可能会看到高于此处显示的速率和突发值。有关更多信息，请参阅销售合作伙伴API中的使用计划和速率限制。

请求参数

Path 参数

asin

string

必需

该商品的亚马逊标准识别号码（ASIN）。

Query 参数

marketplaceIds

array[string]

必需

以逗号分隔的亚马逊市场标识符列表。响应中的数据集仅包含指定市场的数据。

示例值:

ATVPDKIKX0DER

includedData

array[string]

可选

要包括在响应中的数据集的逗号分隔列表。默认值：摘要。

枚举值:

attributesidentifiersimagesproductTypessalesRankssummariesvariationsvendorDetails

默认值:

summaries

示例值:

summaries

locale

string

可选

用于检索本地化摘要的区域设置。默认为市场的主要区域设置。

示例值:

en_US

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

亚马逊目录中的一件商品。

asin

string

必需

亚马逊标准识别码（ASIN）是亚马逊目录中物品的唯一标识符。

attributes

object (ItemAttributes)

可选

一个包含按属性名称键入的结构化项目属性数据的JSON对象。目录项目属性仅对品牌所有者可用，并符合销售合作伙伴API中可用的相关产品类型定义。

额外字段

integer | number | string | boolean

可选

identifiers

array[object (ItemIdentifiersByMarketplace) {2}]

可选

与亚马逊目录中该项目相关的标识符，例如UPC和EAN标识符。

marketplaceId

string

亚马逊市场标识符。

必需

identifiers

array[object (ItemIdentifier) {2}]

必需

与所指示的亚马逊市场中该项目相关的亚马逊目录标识符。

images

array[object (ItemImagesByMarketplace) {2}]

可选

亚马逊目录中商品的图像。所有图像变体都提供给品牌所有者。否则，将提供“主”图像变体的缩略图。

marketplaceId

string

亚马逊市场标识符。

必需

images

array[object (ItemImage) {4}]

必需

亚马逊市场上指定商品的图片。

productTypes

array[object (ItemProductTypeByMarketplace) {2}]

可选

与亚马逊目录项相关的产品类型。

marketplaceId

string

亚马逊市场标识符。

可选

productType

string

可选

与亚马逊目录项目相关的产品类型名称。

示例值:

LUGGAGE

salesRanks

array[object (ItemSalesRanksByMarketplace) {2}]

可选

亚马逊目录商品的销售排名。

marketplaceId

string

亚马逊市场标识符。

必需

ranks

array[object (ItemSalesRank) {3}]

必需

亚马逊市场中亚马逊目录项目的销售排名。

summaries

array[object (ItemSummaryByMarketplace) {9}]

可选

亚马逊目录商品的摘要详情。

marketplaceId

string

亚马逊市场标识符。

必需

brandName

string

可选

与亚马逊目录项目相关联的品牌名称。

browseNode

string

可选

与亚马逊目录项相关联的浏览节点标识符。

colorName

string

可选

与亚马逊目录项目相关的颜色名称。

itemName

string

可选

与亚马逊目录项相关的名称或标题。

manufacturer

string

可选

与亚马逊目录项相关的制造商名称。

modelNumber

string

可选

与亚马逊目录项相关的模型编号。

sizeName

string

可选

与亚马逊目录项关联的尺寸名称。

styleName

string

可选

与亚马逊目录项目相关的风格名称。

variations

array[object (ItemVariationsByMarketplace) {3}]

可选

亚马逊目录项目的市场变体详细信息（变体关系）。

marketplaceId

string

亚马逊市场标识符。

必需

asins

array[string]

必需

相关项目的标识符（ASIN）。

variationType

enum<string>

必需

请求中亚马逊商品目录项与相关项的变体关系类型：“父级”或“子级”。

枚举值:

PARENTCHILD

示例值:

PARENT

vendorDetails

array[object (ItemVendorDetailsByMarketplace) {8}]

可选

与亚马逊目录项相关的供应商详细信息。供应商详细信息仅对供应商可用。

marketplaceId

string

亚马逊市场标识符。

必需

brandCode

string

可选

与亚马逊目录项相关的品牌代码。

categoryCode

string

可选

与亚马逊目录项关联的产品类别。

manufacturerCode

string

可选

与亚马逊目录项目关联的制造商代码。

manufacturerCodeParent

string

可选

制造商代码的父供应商代码。

productGroup

string

可选

与亚马逊目录项相关的产品组。

replenishmentCategory

enum<string>

可选

与亚马逊目录项关联的补货类别。

枚举值:

ALLOCATEDBASIC_REPLENISHMENTIN_SEASONLIMITED_REPLENISHMENTMANUFACTURER_OUT_OF_STOCKNEW_PRODUCTNON_REPLENISHABLENON_STOCKUPABLEOBSOLETEPLANNED_REPLENISHMENT

subcategoryCode

string

可选

与亚马逊目录商品相关的产品子类。

示例

{
  "asin": "B07N4M94X4",
  "identifiers": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "identifiers": [
        {
          "type": "ean",
          "identifier": "0887276302195"
        },
        {
          "type": "upc",
          "identifier": "887276302195"
        }
      ]
    }
  ],
  "images": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "images": [
        {
          "variant": "MAIN",
          "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
          "height": 333,
          "width": 500
        }
      ]
    }
  ],
  "productTypes": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "productType": "TELEVISION"
    }
  ],
  "salesRanks": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "ranks": [
        {
          "title": "OLED TVs",
          "link": "http://www.amazon.com/gp/bestsellers/electronics/6463520011",
          "rank": 3
        },
        {
          "title": "Electronics",
          "link": "http://www.amazon.com/gp/bestsellers/electronics",
          "rank": 1544
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandName": "Samsung Electronics",
      "browseNode": "6463520011",
      "colorName": "Black",
      "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
      "manufacturer": "Samsung",
      "modelNumber": "QN82Q60RAFXZA",
      "sizeName": "82-Inch",
      "styleName": "TV only"
    }
  ],
  "variations": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "asins": [
        "B08J7TQ9FL"
      ],
      "type": "PARENT"
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "brandCode": "SAMF9",
      "categoryCode": "50400100",
      "manufacturerCode": "SAMF9",
      "manufacturerCodeParent": "SAMF9",
      "productGroup": "Home Entertainment",
      "replenishmentCategory": "NEW_PRODUCT",
      "subcategoryCode": "50400150"
    }
  ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应