目录项目API v2022-04-01用例指南

sfgoods 亚马逊SPAPI

API版本: 2022-04-01

# 什么是目录v2022-04-01的API？

使用目录物品的销售伙伴API(Catalog Items API)，您可以检索亚马逊目录中的物品信息. 请参考Catalog Items API Reference了解API操作和相关数据类型和模式的细节.

# 关键功能

检索详细的项目信息目录物品API提供了关于亚马逊目录中物品的详细信息，如

-总结的项目细节 -属性 -产品标识符 -销售排名 -关系 -图像

供应商可以检索额外的供应商-特定的细节.
通过标识符或关键词搜索. 目录物品API允许您通过标识符(如UPC或EAN标识符搜索亚马逊目录物品和相关信息，每个请求最多20个)或通过关键词搜索. 在执行搜索查询或明确通过ASIN检索物品时，可以获得相同的物品细节.

# Terminology

asin: 亚马逊标准识别码，用于识别亚马逊目录中的物品.
SKU: 销售伙伴-提供的库存管理单位，用于识别卖家或供应商的清单.来自一个或多个销售伙伴清单的数据被调节成亚马逊目录中的物品.
变体变化是亚马逊目录项目之间的一种关系，它将因颜色、尺寸或其他属性而不同的项目分组.一个父亚马逊目录项目被用来将子项目分组到变化家族中.例如，一件衬衫可能提供多种尺寸和颜色.在这种情况下，每个不同的尺寸和颜色组合在亚马逊目录中被表示为它自己的项目，有一个父项目将它们分组，以便在亚马逊零售网站上提供一个单一的细节页面.

# Tutorial: 通过标识符(ASIN)检索亚马逊目录中单个商品的详细信息

使用本教程来检索亚马逊目录中某一物品的信息，并给出ASIN和市场.

先决条件

要完成本教程，你需要

-来自你为之调用的销售伙伴的授权.去授权销售伙伴的API应用 (opens new window)了解更多信息.

-在您的开发者档案中批准产品列表角色.

-在应用程序注册页面中为您的应用程序选择的产品列表角色.

# 步骤1：获取一个目录项目的信息

Call the getCatalogItem (opens new window) operation, passing the following parameters:

，在此，我想说的是

Parameter	类型	Example	Description	Required
`asin`	string	`XXXXXXXXXX`	感兴趣的物品的亚马逊标准识别码.	是的

查询参数

Parameter	类型	Example	Description	Required
`marketplaceIds`	< string > array(csv)	`ATVPDKIKX0DER`	A comma-delimited list of Amazon marketplace identifiers. 参考Marketplace IDs，了解亚马逊市场标识符的列表.	是的
`includedData`	< enum (IncludedData) > array(csv)	`summaries`	一个以逗号分隔的项目细节列表，以请求.如果没有指定，将默认返回`summaries`数据. `attributes`产品类型定义API 以获得更多关于检索描述返回属性格式的JSON Schemas的信息. `dimensions` <代码>识别码</代码 - 外部物品标识符，如EAN、UPC、ISBN等. `images` `productTypes`产品类型定义API.进行检索 <代码>关系</代码 - 项目关系数据. 包含代表与此项目相关的父项或子项的ASINs列表. `salesRanks` `summaries` <代码>vendorDetails</代码 -物品供应商数据.对供应商可用.包含物品补货、品牌和制造商信息.	没有
`locale`	弦	`en_US`	检索本地化摘要的地点.默认为市场的主要地点.	没有

示例请求：

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/XXXXXXXXXX
  ?marketplaceIds=ATVPDKIKX0DER
  &amp;includedData=属性,尺寸,标识符,图像,产品类型,销售排名,摘要,关系,供应商详情

1
2
3

响应

一个成功的响应包括以下内容

名称	类型	Description
`asin`	ItemAsin	要求的ASIN.
`属性`	ItemAttributes	一个包含详细的目录项目数据的JSON对象.来自多个市场的值被卷进每个属性名称下的一个列表中. 更多信息请参考产品类型定义API用例指南.
`dimensions`	ItemDimensions	规范化的物品和包装尺寸.
<代码>识别码</代码	ItemIdentifiers	外部标识符，如UPC、EAN等.，如果适用.
`图像`	ItemImages	项目的图像数据.
`productTypes`	ItemProductTypes	物品在亚马逊目录中的产品类型.更多信息请参考产品类型定义API .
<代码>等级</代码	ItemSalesRanks	该物品在其被跟踪的每个类别中的销售排名数据.
<代码>关系</代码	ItemRelationships	代表与此物品相关的父或子物品的ASIN列表.
`summaries`	ItemSummaries	项目数据的摘要.
`vendorDetails`	ItemVendorDetails	该产品的详细供应商信息.

示例响应：

{
  "asin": "B07N4M94X4",
  "属性": {
    "total_hdmi_ports": [
      {
        "值": 4,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "决议": [
      {
        "language_tag": "en_US",
        "值": "4K",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_weight": [
      {
        "单位": "磅",
        "值": 107.6,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "product_subcategory": [
      {
        "值": "50400120",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "bullet_point": [
      {
        "language_tag": "en_US",
        "值": "带有通用指南的智能电视简单的on-screen Guide是寻找流媒体内容和直播电视节目的一种简单方法"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "采用量子点的100%色彩量在量子点的支持下，三星的4K QLED电视提供了超过10亿色调的绚丽色彩和100%的色彩量，实现了特殊的细节深度，将吸引你进入画面，获得最佳的4K电视体验"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "价值": "QUANTUM PROCESSOR 4K: 智能驱动的处理器可将内容即时升级到4K，以获得清晰的细节和精致的色彩"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "价值": "QUANTUM HDR 4X：由HDR10+驱动的4K深度细节和高动态范围，提供最亮到最暗的颜色，逐个场景，实现惊人的画面真实感"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "AMBIENT MODE通过将这个大屏幕电视的空白屏幕变成诱人的视觉效果，包括装饰、信息、照片和艺术品，定制并补充你的生活空间"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "智能电视功能OneRemote控制所有兼容设备，Bixby语音命令，on-屏幕通用指南，SmartThings控制兼容的家用电器和设备，智能音箱的扩展性与Alexa和Google Assistant兼容，以及更多"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_dimensions": [
      {
        "宽度": {
          "单位": "英寸",
          "值": 72.4
        },
        "长度": {
          "单位": "英寸",
          "值": 2.4
        },
        "高度": {
          "单位": "英寸",
          "值": 41.4
        },
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "品牌": [
      {
        "language_tag": "en_US",
        "value": "SAMSUNG",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "generic_keyword": [
      {
        "language_tag": "en_US",
        "值": "OLED 65英寸智能电视QLED 75英寸电视85英寸4K电视智能电视4K电视65英寸QLED 82英寸电视8K电视OLED 65智能电视QLED 65英寸80英寸电视4K 4K电视盾牌电视2018"
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "value": "q9fn qled 2018 oled 4k 4k oled 东芝天线 DVD播放器 户外电视 厨房电视 fire tv firetv hdtv高清电视 安卓盾牌电视 游戏交易 电视耳朵 dvr扬声器 数字电视天线 电视安卓电视框架安装" 
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "value": "4k hdr tv 70 tv shield tv 90 inch tv gaming tv 75 tv 65 inch 4k tv 65 inch smart tv 4k 65 inch 4k tv 4k tv uhd tv uhd tv 4k" 
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "智能电视4K电视电视OLED电视65英寸智能电视4K电视65英寸智能电视盾牌电视2018电视4KOLED电视65 4K电视4K智能电视4K高清电视盾牌电视游戏电视65英寸4K电视电视65英寸智能电视4K电视65英寸4K电视4K电视UHD电视UHD电视4K电视"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "control_method": [
      {
        "值": "语音",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_package_dimensions": [
      {
        "长度": {
          "单位": "cmeters",
          "值": 26.67
        },
        "宽度": {
          "单位": "厘米",
          "值": 121.92
        },
        "高度": {
          "单位": "厘米",
          "值": 203.2
        },
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "image_aspect_ratio": [
      {
        "language_tag": "en_US",
        "value": "16:9",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "part_number": [
      {
        "值": "qn82q60rafxza",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "including_remote": [
      {
        "value": true,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "style": [
      {
        "language_tag": "en_US",
        "值": "仅限电视"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_type_name": [
      {
        "language_tag": "en_US",
        "值": "TV",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "电池": [
      {
        "cell_composition": [
          {
            "值""碱性"
          }
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "image_contrast_ratio": [
      {
        "language_tag": "en_US",
        "值": "QLED 4K",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "制造商": [
      {
        "language_tag": "en_US",
        "值": "三星",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "number_of_boxes": [
      {
        "值": 1,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "total_usb_ports": [
      {
        "值": 2,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "model_number": [
      {
        "值": "qn82q60rafxza",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "supplier_declared_dg_hz_regulation": [
      {
        "值": "not_applicable",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "num_batteries": [
      {
        "数量": 2,
        "类型": "aaa",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "California_proposition_65": [
      {
        "compliance_type": "on_product_combined_cancer_reproductive",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "compliance_type": "化学"
        "chemical_names": [
          "2-乙基己基邻苯二甲酸二酯"
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "显示": [
      {
        "resolution_maximum": [
          {
            "单位": "像素",
            "language_tag": "en_US",
            "值": "3840 x 2160"
          }
        ],
        "size": [
          {
            "单位": "英寸",
            "值": 82
          }
        ],
        "类型": [
          {
            "language_tag": "en_US",
            "值": "QLED"
          }
        ],
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "item_name": [
      {
        "language_tag": "en_US",
        "value": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "list_price": [
      {
        "货币": "USD",
        "价值": 3799.99,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "batteries_required": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "包括可充电电池": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "product_site_launch_date": [
      {
        "值": "2019-03-11T08:00:01.000Z",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "Product_category": [
      {
        "值": "50400100",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "batteries_included": [
      {
        "value": false,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "connectivity_technology": [
      {
        "language_tag": "en_US",
        "值": "蓝牙",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "USB",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "无线",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "HDMI",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "included_components": [
      {
        "language_tag": "en_US",
        "值": "QLED标准智能遥控器",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "电力电缆",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Stand",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "三星智能控制",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "规格_met": [
      {
        "language_tag": "en_US",
        "值": "",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "parental_control_technology": [
      {
        "值": "V-Chip",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "power_consumption": [
      {
        "单位": "watts",
        "值": 120,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "cpsia_cautionary_statement": [
      {
        "值": "no_warning_applicable",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_type_keyword": [
      {
        "值": "qled-televisions",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "number_of_items": [
      {
        "值": 1,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "保修_描述": [
      {
        "language_tag": "en_US",
        "值": "1年制造商",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "max_resolution": [
      {
        "单位": "像素",
        "值": 8.3,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "颜色": [
      {
        "language_tag": "en_US",
        "值": "Black",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "screen_surface_description": [
      {
        "language_tag": "en_US",
        "值": "Flat",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    " item_package_weight": [
      {
        "单位": "kgograms",
        "值": 62.142,
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "speaker_type": [
      {
        "language_tag": "en_US",
        "值": "2CH",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "supported_internet_services": [
      {
        "language_tag": "en_US",
        "值": "Amazon Instant Video",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "YouTube",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Netflix",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "Hulu",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "浏览器",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "tuner_technology": [
      {
        "language_tag": "en_US",
        "值": "模拟调谐器",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "控制器_类型": [
      {
        "language_tag": "en_US",
        "值": "SmartThings",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "语音控制",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "special_feature": [
      {
        "language_tag": "en_US",
        "值": "采用量子点的100%色彩量；量子处理器4K；环境模式；量子HDR 4X；真实游戏增强器"
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "无线_通信技术": [
      {
        "language_tag": "en_US",
        "值": "Wi-Fi::Wi-Fi Direct::Bluetooth",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "model_year": [
      {
        "值": 2019年
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "power_source_type": [
      {
        "language_tag": "en_US",
        "值": "Corded Electric",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "street_date": [
      {
        "值": "2019-03-21T00:00:01Z",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "mounting_type": [
      {
        "language_tag": "en_US",
        "value": "Table Mount",
        "marketplace_id": "atvpdkikx0der"
      },
      {
        "language_tag": "en_US",
        "值": "壁挂式",
        "marketplace_id": "atvpdkikx0der"
      }
    ],
    "refresh_rate": [
      {
        "单位": "hertz",
        "language_tag": "en_US",
        "值": "120",
        "marketplace_id": "atvpdkikx0der"
      }
    ]
  },
  "尺寸": [
    {
      "marketplaceId": "atvpdkikx0der",
      "项目": {
        "高度": {
          "单位": "英寸",
          "值": 41.4
        },
        "长度": {
          "单位": "英寸",
          "值": 2.4
        },
        "重量": {
          "单位": "磅",
          "值": 107.6
        },
        "宽度": {
          "单位": "英寸",
          "值": 72.4
        }
      },
      "包": {
        "高度": {
          "单位": "英寸",
          "值": 10.49999998929
        },
        "长度": {
          "单位": "英寸",
          "值": 79.9999999184
        },
        "重量": {
          "单位": "kgograms",
          "值": 62.142
        },
        "宽度": {
          "单位": "英寸",
          "值": 47.99999995104
        }
      }
    }
  ],
  "标识符": [
    {
      "marketplaceId": "atvpdkikx0der",
      "标识符": [
        {
          "identifier": "0887276302195",
          "标识符类型": "EAN"
        },
        {
          "标识符": "00887276302195",
          "标识符类型": "GTIN"
        },
        {
          "标识符": "887276302195",
          "标识符类型": "UPC"
        }
      ]
    }
  ],
  "图像"[
    {
      "marketplaceId": "atvpdkikx0der",
      "图像": [
        {
          "variant": "MAIN",
          "link": "https://m.media-amazon.com/images/I/91uohwV+k3L.jpg",
          "高度": 1707,
          "宽度": 2560
        },
        {
          "变量": "MAIN",
          "链接": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
          "高度": 333,
          "宽度": 500
        },
        {
          "变量": "PT01",
          "链接": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg",
          "高度": 2560,
          "宽度": 2560
        },
        {
          "变量": "PT01",
          "链接": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg",
          "高度": 500,
          "宽度": 500
        },
        {
          "变量": "PT02",
          "链接": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg",
          "高度": 375,
          "宽度": 500
        },
        {
          "变量": "PT03",
          "链接": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg",
          "高度": 375,
          "宽度": 500
        },
        {
          "变量": "PT04",
          "链接": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg",
          "高度": 1000,
          "宽度": 1000
        },
        {
          "变量": "PT04",
          "链接": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg",
          "高度": 500,
          "宽度": 500
        },
        {
          "变量": "PT05",
          "链接": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg",
          "高度": 1000,
          "宽度": 1000
        },
        {
          "变量": "PT05",
          "链接": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg",
          "高度": 500,
          "宽度": 500
        },
        {
          "变量": "PT06",
          "链接": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg",
          "高度": 1000,
          "宽度": 1000
        },
        {
          "变量": "PT06",
          "链接": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg",
          "高度": 500,
          "宽度": 500
        },
        {
          "变量": "PT07",
          "链接": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg",
          "高度": 1000,
          "宽度": 1000
        },
        {
          "变量": "PT07",
          "链接": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg",
          "高度": 500,
          "宽度": 500
        },
        {
          "变量": "PT08",
          "链接": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg",
          "高度": 1080,
          "宽度": 1920
        },
        {
          "变量": "PT08",
          "链接": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg",
          "高度": 281,
          "宽度": 500
        },
        {
          "变量": "PT09",
          "链接": "https://m.media-amazon.com/images/I/41B5vgmp4IL.jpg",
          "高度": 375,
          "宽度": 500
        },
        {
          "变量": "PT10",
          "链接": "https://m.media-amazon.com/images/I/51S5IY3AV0L.jpg",
          "高度": 375,
          "宽度": 500
        },
        {
          "变量": "PT11",
          "链接": "https://m.media-amazon.com/images/I/41-6bmPtUlL.jpg",
          "高度": 375,
          "宽度": 500
        },
        {
          "变量": "PT12",
          "链接": "https://m.media-amazon.com/images/I/41s9Q6gWJ7L.jpg",
          "高度": 448,
          "宽度": 500
        },
        {
          "变量": "PT13",
          "链接": "https://m.media-amazon.com/images/I/519nG0mRzuL.jpg",
          "高度": 314,
          "宽度": 500
        },
        {
          "变量": "PT14",
          "链接": "https://m.media-amazon.com/images/I/71sHhrGMc7L.jpg",
          "高度": 1097,
          "宽度": 1500
        },
        {
          "变量": "PT14",
          "链接": "https://m.media-amazon.com/images/I/41CH6gKtU5L.jpg",
          "高度": 366,
          "宽度": 500
        },
        {
          "变量": "PT15",
          "链接": "https://m.media-amazon.com/images/I/21-s7QYrTxL.jpg",
          "高度": 500,
          "宽度": 175
        },
        {
          "变量": "EEGL",
          "链接": "https://m.media-amazon.com/images/I/61i3dsKD09L.jpg",
          "高度": 1375,
          "宽度": 370
        },
        {
          "变量": "EEGL",
          "链接": "https://m.media-amazon.com/images/I/41E7ku-qdGL.jpg",
          "高度": 500,
          "宽度": 135
        },
        {
          "variant": "EGUS",
          "链接": "https://m.media-amazon.com/images/I/61i3dsKD09L.jpg",
          "高度": 1375,
          "宽度": 370
        },
        {
          "变量": "EGUS",
          "链接": "https://m.media-amazon.com/images/I/41E7ku-qdGL.jpg",
          "高度": 500,
          "宽度": 135
        }
      ]
    }
  ],
  "productTypes": [
    {
      "marketplaceId": "atvpdkikx0der",
      "产品类型": "电视"
    }
  ],
  "salesRanks": [
    {
      "marketplaceId": "atvpdkikx0der",
      "分类排名": [
        {
          "classificationId": "21489946011",
          "标题": "QLED电视"
          "链接": "http://www.amazon.com/gp/bestsellers/electronics/21489946011",
          "等级": 113
        }
      ],
      "displayGroupRanks": [
        {
          "websiteDisplayGroup": "ce_display_on_website",
          "标题": "电子",
          "链接": "http://www.amazon.com/gp/bestsellers/electronics",
          "等级": 72855
        }
      ]
    }
  ],
  "summaries": [
    {
      "marketplaceId": "atvpdkikx0der",
      "brand": "SAMSUNG",
      "browseClassification": {
        "displayName": "QLED TVs",
        "classificationId": "21489946011"
      },
      "color": "黑色",
      "itemClassification": "base_product",
      "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
      "制造商": "三星",
      "modelNumber": "qn82q60rafxza",
      "packageQuantity": 1,
      "partNumber": "qn82q60rafxza",
      "尺寸": "82-Inch",
      "样式": "只有电视",
      "websiteDisplayGroup": "ce_display_on_website"
    }
  ],
  "关系": [
    {
      "marketplaceId": "atvpdkikx0der",
      "关系": [
        {
          "类型": "VARIATION",
          "parentAsins": [
            "B08J7TQ9FL"
          ],
          "variationTheme": {
            "属性"[
              "颜色",
              "大小"
            ],
            "主题": "尺寸_名称/颜色_名称"
          }
        }
      ]
    }
  ],
  "vendorDetails": [
    {
      "marketplaceId": "atvpdkikx0der",
      "brandCode": "SAMF9",
      "制造商代码": "SAMF9",
      "manufacturerCodeParent": "SAMF9",
      "productCategory": {
        "displayName": "电视机",
        "值": "50400100"
      },
      "产品组": "家庭娱乐",
      "productSubcategory": {
        "displayName": "Plasma TVs",
        "值": "50400120"
      },
      "RepenishmentCategory": "OBSOLETE"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844

# Tutorial: 通过ASINs或产品标识符搜索一个或多个项目

使用本教程检索亚马逊目录中多个物品的信息，并提供ASINs或产品标识符.

先决条件

要完成本教程，你需要

来自你为之调用的销售伙伴的授权. 转到授权销售伙伴API应用程序 (opens new window) 以了解更多信息.

-在您的开发者档案中批准产品列表角色.

-在应用程序注册页面中为您的应用程序选择的产品列表角色.

步骤1.搜索项目

Call the searchCatalogItems (opens new window) operation with the following parameters:

查询参数

时需要

Parameter	类型	Example	Description	Required
`identifiers`	< string > array(csv)	`0887276302195`	A comma-delimited list of product identifiers to search the Amazon catalog for. Note: Cannot be used with `keywords`.	No
`identifiersType`	字符串	`ISBN`	在亚马逊目录中搜索产品标识符的类型. 注意：当提供`标识符`时需要. `ASIN` - 亚马逊标准识别码. `EAN` -欧洲商品编号. `GTIN` -全球贸易项目编号. `ISBN` -国际标准图书编号. `JAN` -日本物品编号. `MINSAN` -Minsan代码. `SKU` -库存单位. `UPC` -唯一产品代码.	没有
`marketplaceIds`	< string > array(csv)	`ATVPDKIKX0DER`	A comma-delimited list of Amazon marketplace identifiers for the request.	Yes
`includedData`	< enum (IncludedData) > array(csv)	`summaries`	一个以逗号分隔的项目细节列表，以请求.如果没有指定，将默认返回`summaries`数据. `attributes`产品类型定义API 以获得更多关于检索描述返回属性格式的JSON Schemas的信息. `dimensions` <代码>识别码</代码 - 外部物品标识符，如EAN、UPC、ISBN等. `images` `productTypes`产品类型定义API.进行检索 <代码>关系</代码 - 项目关系数据. 包含代表与此项目相关的父项或子项的ASINs列表. `salesRanks` `summaries` <代码>vendorDetails</代码 -物品供应商数据.对供应商可用.包含物品补货、品牌和制造商信息.	没有
`locale`	string	`en_US`	用于检索本地化摘要的地点.默认为市场的主要地点.	没有
`sellerId`	string	`XXXXXXXXXXXX`	一个销售伙伴的标识符，如销售商账户或供应商代码. 注意：当`identifiersType`是`SKU`.	No
`pageSize`	integer	`10`	每页要返回的结果数量.	没有
`pageToken`	string		当有多个页面的结果时，获取某个页面的令牌.	没有

使用pageToken参数在结果中分页.参考在搜索亚马逊目录中的物品的响应中分页了解详情.

示例请求：

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items
  ?identifiers=XXXXXXXXX,YYYYYY,ZZZZZZZ
  &amp;identifiersType=ASIN
  &amp;marketplaceIds={{marketplaceIds}}

1
2
3
4

响应

一个成功的响应包括以下内容

名称类型 Description numberOfResults integer 搜索查询所匹配的产品总数.每次请求只返回不超过页数限制的结果，无论找到多少. pagination Pagination 一个包含一个或多个页面标记的JSON对象，可用于获取下一页或上一页的结果. items < Item > array A list of items from the Amazon catalog.每个项目所包含的信息取决于includedData的参数.参考Catalog Items API reference了解更多信息.

示例响应：

{
  "numberOfResults": 3,
  "项目": [
    {
      "asin": "XXXXXXXXX",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "brand": "Fred Perry",
          "颜色": "Wht/Brt Red/Nvy",
          "itemClassification": "base_product",
          "itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
          "制造商": "Fred Perry Men's Apparel",
          "modelNumber": "M1200",
          "包装数量": 1,
          "partNumber": "M1200-748",
          "尺寸": "X-Large",
          "样式": "Twin Tipped Polo Shirt-m1200",
          "websiteDisplayGroup": "apparel_display_on_website"
        }
      ]
    },
    {
      "asin": "YYYYYYYY",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "brand": "Universal",
          "itemClassification": "base_product",
          "itemName": "Dr. Seuss' The Lorax",
          "制造商": "环球",
          "modelNumber": "ALE BOOK",
          "包装数量": 1,
          "partNumber": "mcad61118810d",
          "websiteDisplayGroup": "dvd_display_on_website"
        }
      ]
    },
    {
      "asin": "ZZZZZZZZZZ",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Muck Boot",
          "itemClassification": "variation_parent",
          "itemName": "Muck Boot Women's Muckster 2 Ankle Snow Boot, black",
          "制造商": "Muck Boot",
          "款式": "Muckster 2 Ankle"
          "websiteDisplayGroup": "网站显示组": "网站上的鞋类显示"
        }
      ]
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# Tutorial: 按关键词搜索商品

通过标识符或关键词搜索并返回亚马逊目录物品和相关信息的列表.

先决条件

要成功完成本教程，你必须具备以下条件

-来自你为之调用的销售伙伴的授权.去授权销售伙伴的API应用 (opens new window)了解更多信息.

-在您的开发者档案中批准产品列表角色.

-在应用程序注册页面中为您的应用程序选择的产品列表角色.

步骤1.搜索项目

Call the searchCatalogItems (opens new window) operation with the following parameters:

查询参数

时需要中

Parameter	类型	Example	Description	Required
`brandNames`	< string > array(csv)	`Samsung`	以逗号分隔的品牌名称列表，以细化搜索结果.	没有
`classificationIds`	< string > array(csv)	`7141124011`	以逗号分隔的分类标识符列表，以细化搜索结果.	No
`keywords`	<字符串> array(csv)	`hello`	A comma-delimited list of keywords to search the Amazon catalog for. Note: Cannot be used with `identifiers`.	No
`keywordsLocale`	string	`en_US`	提供的关键词的locale，默认为市场的locale.	没有
`marketplaceIds`	< string > array(csv)	`ATVPDKIKX0DER`	A comma-delimited list of Amazon marketplace identifiers for the request.	Yes
`includedData`	< enum (IncludedData) > array(csv)	`summaries`	一个以逗号分隔的项目细节列表，以请求.如果没有指定，将默认返回`summaries`数据. `attributes`产品类型定义API 以获得更多关于检索描述返回属性格式的JSON Schemas的信息. `dimensions` <代码>识别码</代码 - 外部物品标识符，如EAN、UPC、ISBN等. `images` `productTypes`产品类型定义API.进行检索 <代码>关系</代码 - 项目关系数据. 包含代表与此项目相关的父项或子项的ASINs列表. `salesRanks` `summaries` <代码>vendorDetails</代码 -物品供应商数据.对供应商可用.包含物品补货、品牌和制造商信息.	没有
`locale`	string	`en_US`	用于检索本地化摘要的地点.默认为市场的主要地点.	没有
`sellerId`	string	`XXXXXXXXXXXX`	一个销售伙伴的标识符，如销售商账户或供应商代码. 注意：当`identifiersType`是`SKU`.	No
`pageSize`	integer	`10`	每页要返回的结果数量.	没有
`pageToken`	string	见 `nextToken` 在例子response.	当有多个页面的结果时，A标记来获取某个页面.	没有

使用pageToken参数在结果中分页.参考在搜索亚马逊目录中的物品的响应中分页了解详情.

请求示例：

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items
  .keywords=hello
  &amp;marketplaceIds={{marketplaceIds}}
  &amp;includedData=summaries
  &amp;pageSize=10

1
2
3
4
5

响应

一个成功的响应包括以下内容

名称类型 Description numberOfResults integer 搜索查询所匹配的产品总数.每次请求只返回不超过页数限制的结果，无论找到多少. items < Item > array A list of items from the Amazon catalog.每个项目所包含的信息取决于includedData的参数.参考Catalog Items API reference了解更多信息. pagination Pagination 一个包含一个或多个页面标记的JSON对象，可用于获取下一页或上一页的结果. refinements Refinements A JSON对象，包含品牌和分类搜索的细化内容.

示例响应：

{
  "numberOfResults": 1000,
  "分页"{
    "nextToken": "9HkIVcuuPmX_bm51o3-igBfN45pxW4Ru7ElIM6GCECYCuXJKzT26f5Rj4j72myj91jtjou695yNwt_JvE7qiRtfLOKtyb2IDTpSxcFmiJaztoxrP6fPkv2x86yf7CWqwS7VtDkxYifP8CHvJEnH2oh1lvj7KQoFIa7pWiOPHyaYWP7sBE9Fg7cGN2wE0an5ePw96h6ZL7m6olRxFOcqTWNanEVRjipq"
  },
  "细化"{
    "品牌": [
      {
        "numberOfResults": 328,
        "brandName": "Hello Kitty"
      },
      {
        "numberOfResults": 139,
        "brandName": "TOTOX品牌"
      },
      {
        "numberOfResults": 101,
        "brandName": "Sanrio"
      },
      {
        "numberOfResults": 79,
        "brandName": "Vans"
      },
      {
        "numberOfResults": 73,
        "brandName": "Commonwealth Editions"
      },
      {
        "numberOfResults": 42,
        "brandName": "网络商店"
      },
      {
        "numberOfResults": 38,
        "brandName": "未知"
      },
      {
        "numberOfResults": 38,
        "brandName": "网络商店"
      },
      {
        "numberOfResults": 37,
        "brandName": "FOCO"
      },
      {
        "numberOfResults": 30,
        "brandName": "Skinit"
      }
    ],
    "分类": [
      {
        "numberOfResults": 859,
        "displayName": "书籍",
        "classificationId": "1000"
      },
      {
        "numberOfResults": 595,
        "displayName": "服装、鞋和珠宝",
        "classificationId": "7141124011"
      },
      {
        "numberOfResults": 371,
        "displayName": "家庭和厨房",
        "classificationId": "1063498"
      },
      {
        "numberOfResults": 233,
        "显示名称": "玩具和游戏",
        "classificationId": "165795011"
      },
      {
        "numberOfResults": 197,
        "displayName": "CD &amp; Vinyl",
        "classificationId": "301668"
      },
      {
        "numberOfResults": 156,
        "displayName": "婴儿用品",
        "classificationId": "165797011"
      },
      {
        "numberOfResults": 153,
        "displayName": "其他一切",
        "classificationId": "10304191"
      },
      {
        "numberOfResults": 134,
        "显示名称": "电子",
        "classificationId": "493964"
      },
      {
        "numberOfResults": 125,
        "displayName": "运动与户外",
        "classificationId": "3375301"
      },
      {
        "numberOfResults": 123,
        "displayName": "电影和电视",
        "classificationId": "2625374011"
      }
    ]
  },
  "项目": [
    {
      "asin": "B0013OMKRI",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "HELLO KITTY KT2052A 闹钟收音机，带夜灯(由制造商停产)"
          "制造商": "HELLO KITTY",
          "modelNumber": "KT2052A",
          "包装数量": 1,
          "partNumber": "KT2052A",
          "websiteDisplayGroup": "ce_display_on_website"
        }
      ]
    },
    {
      "asin": "B0015ESWHI"
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "HELLO KITTY KT2053 AM/FM立体声闹钟收音机，带顶部装载CD播放器"
          "制造商": "HELLO KITTY",
          "modelNumber": "KT2053",
          "包装数量": 1,
          "partNumber": "KT2053",
          "websiteDisplayGroup": "ce_display_on_website"
        }
      ]
    },
    {
      "asin": "B009NIYBCS",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "颜色": "粉色/白色"
          "itemClassification": "base_product",
          "itemName": "Hello Kitty女士高尔夫手套套装，粉色/白色，20厘米"
          "制造商": "Hello Kitty Golf",
          "modelNumber": "GLOVE-HKG.M",
          "尺寸": "20cm",
          "websiteDisplayGroup": "website_display_on_website"
        }
      ]
    },
    {
      "asin": "B002W7RDMM",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "HELLO KITTY KT2054投影时钟收音机(由制造商停产)"
          "制造商": "HELLO KITTY",
          "modelNumber": "KT2054",
          "packageQuantity": 1,
          "partNumber": "KT2054",
          "websiteDisplayGroup": "ce_display_on_website"
        
      ]
    },
    {
      "asin": "B00FFECUDQ"
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "Hello Kitty咖啡机",
          "制造商": "Sakar Intl",
          "modelNumber": "app-36209",
          "包装数量": 1,
          "样式": "咖啡机",
          "websiteDisplayGroup": "厨房_显示在网站上"
        }
      ]
    },
    {
      "asin": "1534418717",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "itemClassification": "base_product",
          "itemName": "Hello Robots! (A Hello Book)"
          "制造商": "小西蒙"
          "websiteDisplayGroup": "book_display_on_website"
        }
      ]
    },
    {
      "asin": "B001E0L3MO",
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "HELLO KITTY 12009钥匙扣相框"
          "制造商": "HELLO KITTY",
          "modelNumber": "12009",
          "包装数量": 1,
          "partNumber": "12009",
          "websiteDisplayGroup": "Photo_display_on_website"
        }
      ]
    },
    {
      "asin": "B00021HBU4"
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "Hello Kitty - 2-Slice 宽槽烤面包机，带酷触外观"
          "modelNumber": "KT5211",
          "包装数量": 1,
          "partNumber": "KT5211",
          "websiteDisplayGroup": "扬声器_展示在网站上"
        }
      ]
    },
    {
      "asin": "B010VIOD0S"
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "itemClassification": "base_product",
          "itemName": "Hello Kitty校车玩具套装"
          "制造商": "杰达玩具-美国"
          "modelNumber": "96981",
          "包装数量": 1,
          "partNumber": "96981",
          "websiteDisplayGroup": "网站展示组": "网站上的玩具展示"
        }
      ]
    },
    {
      "asin": "B074NHRVD6"
      "summaries": [
        {
          "marketplaceId": "atvpdkikx0der",
          "品牌": "Hello Kitty",
          "颜色": "珊瑚色/金色"
          "itemClassification": "base_product",
          "itemName": "Hello Kitty 女童装饰短裙, 6, 珊瑚色",
          "制造商": "Hello Kitty",
          "modelNumber": "K3088751AM"
          "packageQuantity": 1,
          "partNumber": "K3088751AM-813-6",
          "尺寸": "6",
          "样式": "Hello Kitty Girls Embellished Tutu Dress",
          "websiteDisplayGroup": "apparel_display_on_website"
        }
      ]
    }
  ]
}

# 在搜索亚马逊目录中的项目的响应中分页

当调用searchCatalogItems (opens new window)操作产生的响应超过pageSize'时，就会发生分页.这意味着响应被分成独立的页面，每个页面在连续的调用中被返回.要检索下一页或前一页，你必须在下一个请求中传递nextToken'值或previousToken'值作为pageToken'参数.

当你调用 "searchCatalogItems "操作并没有提供页面令牌时，你会得到第一页的结果. 然后你使用连续响应中提供的 "nextToken "页面令牌来遍历其余的页面.

页面令牌是特殊的值，通过解码来确定请求的是哪一页，以及前后有多少页.

如果下一个或前一个页面不可用，相应的页面令牌属性(nextToken或previousToken分别)将不会出现在pagination对象中.

例子

当响应不超过pageSize'时，没有分页，所以没有nextToken'或`previousToken'

"pagination": {
},

1
2

当响应超过pageSize而发生分页

对于第一页，没有前一页，所以没有previousToken

"pagination": {
  "nextToken": "XXXXX"
},

1
2
3

对于最后一页，没有下一页，所以没有nextToken

"分页": {
  "previousToken": "XXXXX"
},

1
2
3

对于所有其他页面

"分页": {
  "nextToken": "XXXXX",
  "previousToken": "XXXXX"
},

1
2
3
4

**注意:**页面令牌是特定于请求的.当使用页面令牌时，你不能在下次请求时改变页面大小.

注意: 即使可以有超过1000个符合搜索条件的ASIN，但可以返回和分页的最大结果数量被限制在1000个. 例如，如果调用者将pageSize设置为10，可能的最大页面数量为100.

Catalog Items API v2020-12-01 Easy Ship API v2022-03-23

Amazon Selling Partner API - spapi.cyou

Choose mode