APIClaw — 面向 AI 智能体的电商数据基础设施

实时访问 2 亿+ Amazon 商品。6 个端点，仅需一个 API 密钥。

语言规则：请使用用户所用语言响应。

快速开始

1. 获取 API 密钥：apiclaw.io/api-keys
2. 设置环境变量：export APICLAW_API_KEY='hms_live_xxx'
3. 基础 URL：https://api.apiclaw.io/openapi/v2
4. 认证方式：Authorization: Bearer YOUR_API_KEY
5. 所有端点均采用 POST 方法，并以 JSON 格式提交请求体

新生成的密钥需 3–5 秒激活。若返回 403 错误，请稍候重试。

API 端点列表

端点详情

1. 类目（categories）

浏览或搜索 Amazon 类目层级结构。

POST /openapi/v2/categories
{"categoryKeyword": "pet supplies"}                    # 按关键词搜索
{"parentCategoryPath": ["Pet Supplies"]}               # 浏览子类目

⚠️ 请使用 categoryKeyword（而非 keyword）和 parentCategoryPath（而非 parentCategoryName）。

2. 市场（markets）

类目级市场指标 —— 回答“该市场是否值得进入？”

POST /openapi/v2/markets/search
{"categoryPath": ["Pet Supplies", "Dogs", "Toys"], "topN": "10"}

⚠️ topN 必须为 字符串（例如 "3"、"5"、"10"、"20"），不可为整数。

返回字段包括：sampleAvgMonthlySales、sampleAvgPrice、sampleBrandCount、sampleSellerCount、topSalesRate（集中度）、sampleNewSkuRate、sampleFbaRate。

3. 商品（products）

支持过滤条件或 14 种内置选品模式的商品搜索。

POST /openapi/v2/products/search
{"keyword": "yoga mat", "mode": "beginner"}

14 种模式：beginner、fast-movers、emerging、long-tail、underserved、new-release、fbm-friendly、low-price、single-variant、high-demand-low-barrier、broad-catalog、selective-catalog、speculative、top-bsr。

关键字段：atLeastMonthlySales（月销量下限估算值）、bsrRank（整型）、ratingCount（非 reviewCount）、price、profitMargin、fbaFee。

4. 竞品（competitors）

通过关键词、品牌或指定 ASIN 发现竞品。

POST /openapi/v2/products/competitor-lookup
{"keyword": "wireless earbuds"}
{"asin": "B09V3KXJPB"}

返回字段与 products/search 相同。

5. 实时商品（realtime/product）

单个 ASIN 的实时数据 —— 当前 Listing 内容与价格。

POST /openapi/v2/realtime/product
{"asin": "B09V3KXJPB"}

关键响应字段：

⚠️ 不返回以下字段：atLeastMonthlySales、profitMargin、fbaFee、sellerCount；如需这些字段，请调用 products/competitor-lookup。
⚠️ 价格字段位于嵌套路径：buyboxWinner.price，而非顶层 price 字段。

6. 评论分析（reviews/analyze）

基于客户评论的 AI 驱动消费者洞察。

POST /openapi/v2/reviews/analyze

# 单个或多个 ASIN（mode 与 asins 均为必填）
{"mode": "asin", "asins": ["B09V3KXJPB"]}
{"mode": "asin", "asins": ["B09V3KXJPB", "B08YYYYY"]}

# 类目级洞察
{"mode": "category", "categoryPath": "Pet Supplies,Dogs,Toys", "period": "90d"}

# 按特定维度筛选
{"mode": "asin", "asins": ["B09V3KXJPB"], "labelType": "painPoints"}

⚠️ mode 为 必填项（仅支持 "asin" 或 "category"）。
⚠️ 请使用复数形式的 asins（数组），而非单数形式的 asin（字符串）。

共支持 11 类洞察维度（labelType）：painPoints、improvements、buyingFactors、issues、positives、scenarios、keywords、userProfiles、usageTimes、usageLocations、behaviors。

返回字段包括：totalReviews、avgRating、sentimentDistribution、ratingDistribution、consumerInsights、topKeywords、verifiedRatio。

⚠️ 各端点字段差异说明

四种端点类型返回的 字段完全不同，切勿假设其结构一致。

各端点适用场景

已知特殊行为（Known Quirks）

1. topN 和 newProductPeriod 均为 字符串 —— 请使用 "10"，而非 10
2. listingAge 为 字符串 —— 请使用 "180"，而非 180
3. 所有响应中的 .data 字段均为 数组 —— 请使用 .data[0] 访问首条数据，而非 .data.fieldName
4. 统一使用 ratingCount（而非 reviewCount）—— 所有端点中该字段名均为 ratingCount
5. bsrRank（整型）见于 products/competitors 端点；bestsellersRank（数组）见于 realtime 端点
6. 速率限制：100 次请求/分钟，突发峰值 10 次请求/秒

积分说明（Credits）

• 每次 API 调用消耗相应积分
• 响应中包含 meta.creditsConsumed 与 meta.creditsRemaining
• reviews/analyze 要求目标商品至少拥有 50 条评论（否则返回 INSUFFICIENT_REVIEWS 错误）
• 套餐与计费详情：apiclaw.io/pricing

数据说明

• 月销量（atLeastMonthlySales）为下限估算值 —— 实际值可能更高
• 实时数据 vs 数据库数据：realtime/product 为实时抓取；products/competitors 存在约 T+1 延迟
• 当前仅支持 Amazon 美国站（amazon.com）—— 更多站点正在规划中
• 销量估算回退机制：当 atLeastMonthlySales 为 null 时，月销量 ≈ 300,000 / BSR^0.65

深入探索

如需开展更高级的 Amazon 商品研究 —— 包括 14 种选品策略、风险评估、定价分析、Listing 优化及运营监控 —— 请安装专用技能：

clawhub install Amazon-analysis-skill

相关链接

• 官网：apiclaw.io
• API 文档：api.apiclaw.io/api-docs
• GitHub：github.com/SerendipityOneInc
• 技术支持：support@apiclaw.io