企业官网建设流程全解析

1. Catalog Items API v2022-04-01【查全网任意 ASIN，竞品详情】

用途：输入 ASIN，拉取亚马逊公共目录公开商品数据（标题、图片、类目、五点、价格、变体、BSR 排名、参数），无需拥有该商品店铺，选品、竞品监控核心接口developer-...。

• 核心接口：getCatalogItem（单 ASIN 详情）、searchCatalogItems（关键词搜商品列表）
• 请求地址示例（美站）

http

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/B0XXXXXXXXX?marketplaceIds=ATVPDKIKX0DER&includedData=summaries,attributes,images,salesRanks,variations

• includedData参数控制返回哪些详情模块（必须传）：
  • summaries：商品标题、品牌、ASIN、主图、前台短描述（对应item_name标题）
  • attributes：材质、尺寸、规格、五点描述 bullet_point、长描述 product_description
  • images：全部主图 / 辅图链接
  • salesRanks：类目 BSR 销量排名
  • variations：变体父子 ASIN、颜色尺寸对应关系

返回标题关键字段（summaries.title）

json

"summaries": [ { "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 个核心操作：

1. getListingsItem：根据 SKU 读取本店完整 Listing 详情（标题、ST、A+、合规属性）
2. putListingsItem：新建商品，写入item_name标题、所有属性
3. patchListingsItem：仅局部更新标题 / 价格 / 图片
4. deleteListingsItem：下架删除 SKU

读取标题返回结构（getListingsItem）

json

"attributes": { "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/patch）

json

"attributes": { "item_name": ["Wireless Bluetooth Earbuds IPX7 Waterproof Noise Canceling Headphones"] }

二、标题 item_name API 强制规范（2026 全站点 75 字符新规）

1. 硬性校验规则（API 直接报错拦截）

1. 字符限制
   • 前台展示有效：≤75 字符（含空格），超出前台截断丢失关键词；底层最大支持 200 字符，但新上架强制遵循 75 字符，否则 Listing 抑制SuppressedAmazon Sel...
   • 报错码：90225item_name 超出最大长度
2. 禁用内容
   • 促销词：Free Shipping、Hot Sale、Discount、Guarantee、Christmas Gift
   • 极限词：Best、Top、Ultra、Premium
   • 特殊符号：! $ ? _ { } ^ ¬ ¦全部禁止
   • HTML 标签、emoji：报错90199禁止 HTML 标签
3. 大小写规范（API 校验） 实词首字母大写，短介词for/with/and/in小写，禁止全大写 ✅Soft Silicone Case for iPhone 16 Pro Max❌SOFT SILICONE CASE FOR IPHONE 16 PRO MAX

2. API 标准标题结构（75 字符内，搜索权重最高）

品牌 + 核心大词 + 规格尺寸 + 1个核心功能长尾卖点、场景全部放入bullet_point五点，不要塞进标题挤占字符。

三、完整返回字段总览（商品详情全数据）

Catalog Items（竞品详情）

1. identifiers：UPC/EAN/GTIN 条码
2. summaries：标题 title、品牌、主图、价格
3. attributes：材质、尺寸、重量、颜色、型号、五点描述
4. images：所有图片 CDN 链接（img-amazon、m.media-amazon）
5. salesRanks：各一级 / 二级类目 BSR 排名
6. variations：父子变体 ASIN、颜色 / 尺寸变体主题
7. classifications：类目节点 Browse Node

Listings Items（本店 Listing）

1. item_name：上架标题（API 编辑核心字段）
2. brand、manufacturer、model_number：品牌型号
3. bullet_point：5 点描述（数组）
4. product_description：长描述
5. main_image、other_image：图片数组
6. generic_keyword：Search Terms 搜索词
7. item_package_dimensions /item_package_weight：包装尺寸重量
8. compliance：合规信息（加州 65、食品级）

四、常见 API 标题报错 & 解决方案

1. 90225 item_name 超长原因：标题超过 75 字符前台标准 / 200 底层上限 解决：删减场景、多余卖点，只保留核心词，次要信息移至五点
2. 90199 包含 HTML 标签原因：标题带<b> <br>等网页标签 解决：正则过滤所有 HTML 标记，仅保留纯文本
3. InvalidItemName 参数无效原因：非法特殊符号、全大写、大量关键词堆砌 解决：清理禁用符号，标准化大小写，同一单词不重复 3 次以上
4. Listing Suppressed 商品抑制原因：标题违规、超长、含促销词，平台隐藏链接 解决：重写合规 75 字符标题后 patch 更新

五、极简调用示例（Patch 修改商品标题）

请求 URL

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}

请求 Body

json

{ "marketplaceIds": ["ATVPDKIKX0DER"], "patches": [ { "op": "replace", "path": "/attributes/item_name", "value": ["High Waist Tummy Control Stretchy Yoga Leggings"] }