2026 年 11 月数据升级说明
Ecommerce Data API 在 2026 年 11 月 19 日完成数据升级。本页列出已下线的接口、不再返回的字段、新的限制,以及 MCP 客户端和 Skill 的更新方法。
2026 年 11 月数据升级说明
2026 年 11 月 19 日,Amazon 接口背后的数据换成了新一代。接口路径、鉴权方式、请求参数名和计费都没有变。有 10 个接口下线,部分接口返回的字段变少,几项限制有调整。TikTok、1688 和图片文字识别接口不受影响。
你需要做什么
| 你的用法 | 操作 |
|---|---|
| 远程 MCP | 在客户端里重新连接服务,或刷新工具列表。现在共 54 个工具。 |
Skill 和 ecomdata | 运行 ecomdata update。当前 Skill 版本是 0.3.4。 |
| REST API | 停止调用下面已下线的接口,停止读取已移除的字段。你现在发送的请求体仍然有效。 |
| 保存过的提示词和智能体 | 删掉旧对话里的工具名和字段名。让智能体先列出当前工具,不要凭记忆直接调用。 |
已下线的接口
这些接口返回 410 ENDPOINT_RETIRED,不扣费。对应的 MCP 工具也不再列出。
| 接口 | 路径 |
|---|---|
| 关键词选品列表 | /v1/amazon/keyword-research |
| 竞品列表 | /v1/amazon/asin/competitor |
| 优惠券趋势 | /v1/amazon/asin/coupon-trend |
| 带优惠券数据的商品详情 | /v1/amazon/asin/with-coupon-trend |
| 流量来源 | /v1/amazon/traffic/source |
| 关联商品统计 | /v1/amazon/traffic/listing/stat |
| 商标统计 | /v1/global/brand/stats |
| 商标搜索 | /v1/global/brand/list |
| 商标详情 | /v1/global/brand/detail |
| 商标覆盖范围 | /v1/global/brand/range |
这些路径的旧别名同样下线。仍然开放的接口见接口目录。
行为变化
| 范围 | 以前 | 现在 |
|---|---|---|
| 评论 | 可以翻页取到全部已存评论 | 只能取最新 100 条,再往后翻页返回 400 PAGE_NOT_AVAILABLE。「免费评论」和「抢先体验」两个标记不再返回。 |
| 商品搜索和选品 | 关键词匹配包含任意一个词的商品 | 关键词匹配包含全部词的商品。必须提供关键词、ASIN、类目或品牌中的一项。 |
| 商品搜索和选品 | 筛选条件和排序字段较多 | 部分筛选和排序返回 400 VALIDATION_ERROR。每次只能查一个类目路径,每个查询最多 2,000 条。 |
| 商品详情 | 卖家数、小类排名、优惠券、Listing 评分 | 这些字段不再返回。 |
| ASIN 销量预测 | 较长的每日数据,含价格和销售额 | 每日销量约 65 天。月度数据不变。 |
| 市场分析 | 不传 month 表示最近 30 天 | 不传 month 表示最近一个完整自然月。分布结果里不再附带 ASIN 列表。 |
| ABA 搜索词 | 4 周和 12 周排名变化、竞价、头部品牌 | 这些字段不再返回。现在必须传 includeKeywords,不传会返回 400 VALIDATION_ERROR。 |
| 反查关键词 | 名次、所在页码和页内位置 | 只返回名次。 |
| 关键词 | 关键词译文字段 | 不再返回。 |
每个接口的文档页列出了当前返回的字段。
会指向本页的错误
| 错误码 | 出现位置 | 含义 |
|---|---|---|
ENDPOINT_RETIRED | REST 和 MCP | 接口或操作已下线,不扣费。 |
TOOL_NOT_FOUND | MCP | 工具名不在当前列表里,请刷新工具列表。 |
INVALID_TOOL_ARGUMENTS | MCP | 参数与工具当前的输入结构不符,请重新读取输入结构。 |
VALIDATION_ERROR | REST 和 MCP | 错误信息提到本次升级时,表示该筛选或排序已不再提供。 |
PAGE_NOT_AVAILABLE | 评论 | 请求的页超出了最新 100 条评论。 |
以上错误都不扣费,不要原样重试。响应格式见错误与限流。
ASIN 监控
ecomdata watch 不再观测 coupon 和 sellers,两者一直是 null。这两个字段从有值变成 null 是升级造成的,不代表优惠券取消或卖家离开。