这是什么网站？
Ecommerce Data API 提供第三方电商研究数据，眼下公开能力集中在 Amazon：商品 Listing、关键词、类目市场、关联流量和评论，另外还有全球商标、图片里的中文与拉丁文字，以及 Google 搜索兴趣曲线。卖家官方接口覆盖的是自己账号里的订单和库存；这个站补的是任意 ASIN 上的研究字段，请求返回 JSON，不用自己解析页面。首页写着 Amazon 接口目录仍在持续开发。销量、搜索量和销售额都是模型估算，同一时期内可以横向比较，不能当成 Amazon 公布的成交数字。
核心功能
- 商品详情接收一个 ASIN，返回标题、价格、优惠、大类 BSR、小类排名、星级、评分数、带文字的评论数、卖家、配送方式、变体列表和 Listing 质量分。站点代码包括 US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE。没有 UPC 或 EAN 参数，条码要先换成 ASIN。
- 关键词研究按「站点、月份、关键词」给出估算月搜索量、购买量、购买率、竞品数、供需比和建议竞价区间，可按搜索量、词数排除品牌词后排序。
month用yyyyMM时最多回溯 24 个月，nearly表示近 30 天。 - 销量接口分三条：按 ASIN 出日销量与月销量及销售额，按 ASIN 出父体/子体月趋势，或按类目 BSR 换算。子体销量在趋势接口里是整数档位。没有可用估算时返回
422，这次不计费。 - 市场分析看类目规模、商品和品牌集中度、价格带、评分和需求趋势；流量分析看关联商品、流量来源和关键词流向。
- 商标接口可搜列表、读详情、看注册状态统计和覆盖的国家与机构。图片文字识别接受图片 URL、Base64 或文件上传。
- 生产环境基址是
https://ecommercedataapi.com，公开版本为v1。鉴权用X-API-Key或Authorization: Bearer，二选一。密钥可撤销；直连用户的频率、并发和额度按账户汇总，多建几把 Key 不会加配额。
常见使用场景
- 选品的人先用关键词接口把月搜索、购买率和竞品数收成一张表，再拉 Google Trends。兴趣分值每次被缩放到最高 100，只能看曲线形状，不能把两个词的分值直接相减，也不能当成 Amazon 销量。
- 做竞品看板的人每天拉同一 ASIN 的价格、BSR、评分和优惠。记录里有
updatedTime；商品页也提醒，排名会在两次快照之间变动。 - 看类目的人用市场统计看集中度和价格带，再用销量估算给头部 ASIN 排序。不同类目的同一个 BSR 没有可比性，类目整体变冷时排名可能不动、销量却掉。
- 上架前查品牌的人用商标列表和详情看注册状态，再决定标题里能不能用这个名字。榜单页是另一条路：每张榜是所示日期的一次快照，前 20 行公开，登录后最多 100 行并可导出 CSV。
- 只想管自己店铺入库、订单和广告报表的卖家，这里没有卖家账号授权后的经营数据。那部分在 Amazon Selling Partner API 和广告 API。
适合哪些用户？
- 要给后台、定时任务或数据管道接 Amazon 研究字段的开发者。文档提供 OpenAPI、Postman 和可复制的请求示例，也提到可通过 RapidAPI 订阅。
- 做关键词库、竞品监控和备货判断、又不想自己维护抓取的运营和分析师。
- 想在 Codex、Claude Code 或 Cursor 里用文字描述任务再取数的人。开发文档把这条路径写成本机
ecomdataCLI 加 Skill，并写明不会安装公开 MCP 服务；商品等产品页则写这些接口已作为远程 MCP 工具提供。接之前以当时的文档为准。两种路径共用 Key 和额度。 - 要生成联盟链接的人更适合联盟侧的 Creators API（原 Product Advertising API）；要查自己账号销量的人用 Selling Partner API。本站明确写自己不是这两类官方接口。
- 需要把销量写成审计数字或对外承诺的团队不适合。方法论页写明榜单和接口里的销量、销售额、搜索量来自第三方估算。
与同类工具的对比？
Amazon 侧至少有三条不同的路，本站文档是按「你要查谁的商品」来分的，不是排名。
联盟接口面向带货链接，覆盖公开目录，不提供 BSR 历史、销量估算或 Listing 质量分，接入要联盟账号。Selling Partner API 面向已授权的卖家和供应商，能管自己的 Listing、库存和入库，别人的 ASIN 只有有限的目录信息和当前排名。Ecommerce Data API 用 API Key 查 13 个站点上的任意 ASIN，字段偏研究：变体、质量分、关键词估算、市场分布和销量模型。
和自己写爬虫比，这里换来的是固定 JSON、统一错误体和按次额度，换出去的是覆盖范围由目录决定——首页写着 45 个接口已开放，商品 12 个、关键词 11 个、市场 14 个、流量 3 个、商标 4 个、图片文字识别 1 个。请求体超过 64 KB 会 413；参数或鉴权错误不应原样重试。
费用按调用次数，不按席位。月订阅三档：900 次约 US$9、3,500 次约 US$29、13,000 次约 US$79，未用完的次数月底清零；年付一次扣款，次数仍按月发。一次性调用包 60 天有效，公开标价从 50 次 US$1.99、600 次 US$6.99、1,500 次 US$13.99 到 8,000 次 US$69.99。博客写新账号验证邮箱后有 5 次测试调用，24 小时内有效，没有长期免费额度。单个成功计费请求目前扣 1 次，接口另有说明时以该文档为准。402 是余额不足，429 是频率或并发超限。
常见问题
Q: Ecommerce Data API 是亚马逊官方商品 API 吗？
A: 不是。站点写明官方商品接口用于联盟链接，Selling Partner API 管理自己的卖家账号。这里返回 BSR、变体、Listing 质量分和销量估算，调用凭证是 API Key。
Q: 接口里的销量和搜索量能直接当作成交吗？
A: 不能。关键词页和销量页都写这些是估算，适合比较词语或商品、看变化方向。趋势接口里的子体销量是档位。422 表示这次输入没有估算结果，重试不会变出数字。
Q: 额度怎么扣，调用包和订阅有什么差别？
A: 全部公开接口共用一个余额。订阅按月发次数，月底清零；调用包一次性购买，60 天有效。成功计费一般扣 1 次。ASIN_NOT_FOUND、INVALID_PARAMETERS 和 PAGE_NOT_AVAILABLE 不计费。用量页保留脱敏后的请求体和最多 20 KB 响应，保存 7 天。
Q: 程序直连和 AI Agent 是两套数据吗？
A: 不是。文档写两者共用 API Key、Credits 和同一批 v1 REST 接口。Agent 侧通过本机 CLI 与 Skill 选接口；线上目录更新后不必重装 Skill。部分产品页另外声称提供远程 MCP。是否走 MCP，以你打开文档时的说明为准。
