API 使用文档
在账号中创建 API 密钥后，即可请求评论、商品详情和畅销榜数据。以下示例仅展示请求格式，不会实际发起调用。
独立数据 API 尚未开放，以下文档仅供参考。当前可通过 MCP 和已登录的浏览器插件采集数据。
curl --request POST \
--url 'https://sellerside.ai/api/v1/developer/products' \
--header "Authorization: Bearer $SELLERSIDE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"asin":"<ASIN>","market":"US","async":true}'示例仅供复制参考，此页面不会发送请求。
认证与请求头
Authorization: Bearer <SELLERSIDE_API_KEY>
请使用 SellerSide.ai API 密钥。密钥仅在创建时显示一次，之后可在 API 密钥设置中撤销。
Idempotency-Key: <your-key>
重试同一请求时，请使用相同的幂等键。幂等键与参数都相同时，将返回已有任务，不会重复创建。
三类数据接口
| 数据类型 | 接口路径 | 请求参数 | 所需权限 |
|---|---|---|---|
| 评论数据 | POST /api/v1/developer/reviews | asin, market, pageCount, filterByStar, sortBy, async | api:reviews |
| 商品详情 | POST /api/v1/developer/products | asin, market, async | api:products |
| 畅销榜单 | POST /api/v1/developer/best-sellers | content, market, async | api:best-sellers |
market 默认为 US。评论支持 US、CA、MX、UK、DE、JP、AU、IN、EG、AE，pageCount 可填 1–10。filterByStar 可筛选全部评分、指定的 1–5 星评分、好评或差评；sortBy 可填 recent 或 helpful。商品详情和畅销榜支持 13 个站点。商品详情的 asin 需为 10 位字母和数字；畅销榜的 content 填写类目关键词，无需填写类目节点 ID 或页码。
结果保留数据字段的名称、类型和嵌套结构，例如评论中的 totalReviews，以及榜单中的 category、offset 和 nextPage，同时返回任务状态和分页信息。字段为 null 表示暂无可用数据。
POST · 提交任务
返回 SellerSide.ai 任务 ID、状态及错误码。设置 async: true 后，会先返回待处理任务，无需等待采集完成。
GET · 查询状态
/api/v1/developer/tasks/<id>
查询自己账号下的任务是等待中、已完成还是失败。
GET · 读取结果
/api/v1/developer/tasks/<id>/results?page=1&size=50
分页读取已完成任务的数据，返回结果包含 results、total 和 hasNextPage。
额度与错误说明
有效付费会员才可创建密钥并调用接口。已受理的评论任务按请求页数扣除额度；商品详情和榜单任务每次扣除 1 次额度。查询任务状态和读取已保存的结果不重复扣额。额度用尽时返回 ALLOWANCE_EXHAUSTED；其他错误码包括 AUTH_REQUIRED、RATE_LIMITED、INVALID_ARGUMENT 和 TASK_NOT_FOUND。