亚马逊商品详情 API 有哪些接口?如何获取 ASIN 标题、图片、变体数据

发布时间:2026/8/11 8:06:58
亚马逊商品详情 API 有哪些接口?如何获取 ASIN 标题、图片、变体数据 1. Catalog Items API v2022-04-01【查全网任意 ASIN竞品详情】用途输入 ASIN拉取亚马逊公共目录公开商品数据标题、图片、类目、五点、价格、变体、BSR 排名、参数无需拥有该商品店铺选品、竞品监控核心接口developer-...。核心接口getCatalogItem单 ASIN 详情、searchCatalogItems关键词搜商品列表请求地址示例美站httpGET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/B0XXXXXXXXX?marketplaceIdsATVPDKIKX0DERincludedDatasummaries,attributes,images,salesRanks,variationsincludedData参数控制返回哪些详情模块必须传summaries商品标题、品牌、ASIN、主图、前台短描述对应item_name标题attributes材质、尺寸、规格、五点描述 bullet_point、长描述 product_descriptionimages全部主图 / 辅图链接salesRanks类目 BSR 销量排名variations变体父子 ASIN、颜色尺寸对应关系返回标题关键字段summaries.titlejsonsummaries: [ { title: 32oz Stainless Steel Vacuum Insulated Water Bottle Leakproof Travel Mug, brand: YourBrand, asin: B0XXXXXXXXX } ]2. Listings Items API【本店商品读写完整 Listing 编辑】用途操作自己店铺 SKU读取本店完整上架信息 新建 / 修改商品标题、五点、图片、参数上架 ERP 核心接口字段item_name是上架标题字段Amazon。 4 个核心操作getListingsItem根据 SKU 读取本店完整 Listing 详情标题、ST、A、合规属性putListingsItem新建商品写入item_name标题、所有属性patchListingsItem仅局部更新标题 / 价格 / 图片deleteListingsItem下架删除 SKU读取标题返回结构getListingsItemjsonattributes: { item_name: [32oz Stainless Steel Vacuum Insulated Leakproof Water Bottle], brand: [YourBrand], bullet_point: [Food Grade Stainless Steel,24 Hours Cold Insulation], product_description: Long detail description... }上传 / 修改标题入参put/patchjsonattributes: { item_name: [Wireless Bluetooth Earbuds IPX7 Waterproof Noise Canceling Headphones] }二、标题 item_name API 强制规范2026 全站点 75 字符新规1. 硬性校验规则API 直接报错拦截字符限制前台展示有效≤75 字符含空格超出前台截断丢失关键词底层最大支持 200 字符但新上架强制遵循 75 字符否则 Listing 抑制SuppressedAmazon Sel...报错码90225item_name 超出最大长度禁用内容促销词Free Shipping、Hot Sale、Discount、Guarantee、Christmas Gift极限词Best、Top、Ultra、Premium特殊符号! $ ? _ { } ^ ¬ ¦全部禁止HTML 标签、emoji报错90199禁止 HTML 标签大小写规范API 校验 实词首字母大写短介词for/with/and/in小写禁止全大写 ✅Soft Silicone Case for iPhone 16 Pro Max❌SOFT SILICONE CASE FOR IPHONE 16 PRO MAX2. API 标准标题结构75 字符内搜索权重最高品牌 核心大词 规格尺寸 1个核心功能长尾卖点、场景全部放入bullet_point五点不要塞进标题挤占字符。三、完整返回字段总览商品详情全数据Catalog Items竞品详情identifiersUPC/EAN/GTIN 条码summaries标题 title、品牌、主图、价格attributes材质、尺寸、重量、颜色、型号、五点描述images所有图片 CDN 链接img-amazon、m.media-amazonsalesRanks各一级 / 二级类目 BSR 排名variations父子变体 ASIN、颜色 / 尺寸变体主题classifications类目节点 Browse NodeListings Items本店 Listingitem_name上架标题API 编辑核心字段brand、manufacturer、model_number品牌型号bullet_point5 点描述数组product_description长描述main_image、other_image图片数组generic_keywordSearch Terms 搜索词item_package_dimensions /item_package_weight包装尺寸重量compliance合规信息加州 65、食品级四、常见 API 标题报错 解决方案90225 item_name 超长原因标题超过 75 字符前台标准 / 200 底层上限 解决删减场景、多余卖点只保留核心词次要信息移至五点90199 包含 HTML 标签原因标题带b br等网页标签 解决正则过滤所有 HTML 标记仅保留纯文本InvalidItemName 参数无效原因非法特殊符号、全大写、大量关键词堆砌 解决清理禁用符号标准化大小写同一单词不重复 3 次以上Listing Suppressed 商品抑制原因标题违规、超长、含促销词平台隐藏链接 解决重写合规 75 字符标题后 patch 更新五、极简调用示例Patch 修改商品标题请求 URLPATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}请求 Bodyjson{ marketplaceIds: [ATVPDKIKX0DER], patches: [ { op: replace, path: /attributes/item_name, value: [High Waist Tummy Control Stretchy Yoga Leggings] }