如何通过SP API将网站产品分类及变体同步至亚马逊？

一、核心适配的SP API端点 #

1. 产品分类（类目）相关 #

• Catalog Items API：
  • 使用/catalog/items/{marketplaceId}/search端点，可通过网站产品的关键词、属性或竞品ASIN，匹配亚马逊官方类目，获取关键的类目节点ID（Category Node ID）和productType值，这是后续创建合规产品的基础。
  • 调用/catalog/categories/{marketplaceId}可获取亚马逊完整的类目层级结构，帮你精准映射自身网站的分类体系。
• Listings Items API：创建或更新产品时，需在请求体的productType字段指定对应类目，该字段值需匹配Catalog Items API返回的官方类目标识。

2. 产品变体/选项相关 #

• Listings Items API：
  • 核心操作端点为/listings/items/{sellerId}/{marketplaceId}，支持构建父-子变体结构：父商品需设置parentage为parent，子商品设为child，并通过relationships字段关联父ASIN；变体属性（如尺寸、颜色）需在attributes的variationTheme字段定义（例如"variationTheme": "SizeColor"），子商品需分别配置对应属性值。
  • 批量同步变体可使用/listings/items/batch/{sellerId}/{marketplaceId}端点，提升批量操作效率。
• Catalog Items API：通过/catalog/items/{marketplaceId}/asin/{asin}获取同品类竞品的变体结构，作为自身变体数据格式的参考模板。

二、实操技巧 #

• 先完成类目映射：优先将网站产品分类与亚马逊官方类目做对应映射，可通过搜索同品类热销商品的类目信息，确保归类符合亚马逊规则，避免因类目错误导致产品审核失败。
• 严格遵循变体规则：变体必须归属同一父类目，且variationTheme需符合对应类目允许的变体维度（如服饰类支持Size/Color，电子类支持Capacity），可参考亚马逊后台类目指南或竞品结构确认。
• 分步测试验证：先在沙箱环境创建单个父-子变体组合，验证API调用成功后，再逐步推进批量同步，降低出错风险。

内容的提问来源于stack exchange，提问作者Tommy Hoang