接口参考
业务状态码
所有接口的 HTTP 状态码都是 200,业务结果以响应体中的 code 为准。
所有接口的 HTTP 状态码都是 200,业务结果以响应体中的 code 为准。
枚举值
| 值 | 描述 |
|---|---|
200 |
成功 |
400 |
请求参数错误或业务错误,具体原因见 message |
401 |
未授权:API Key 缺失或无效,或账户已被禁用。API Key 被禁用或删除后,最多 60 秒内失效 |
404 |
资源不存在,例如店铺/商品不存在、查询的店铺不在监控中 |
409 |
重复操作,例如店铺已在监控中 |
429 |
请求过于频繁:超过每分钟请求数限制(默认每个账户 200 次/分钟),请稍后再试 |
403001 |
拒绝访问:对应类型的 Credits 不足(Credits、Keyword Credits 或 Monitor Credits,见响应中的 credits.type) |
403002 |
拒绝访问:没有查看权限。店铺/商品需要在 3 天内由列表或详情接口返回过;关键词需要在 30 天内通过关键词搜索查询过 |
500 |
服务器内部错误,本次请求已扣除的 Credits 会自动退还 |
403002 说明
部分接口不扣费,但要求先通过扣费接口获取数据,防止绕过列表直接按 ID 批量拉取:
- 3 天规则:店铺列表、热销店铺榜、已关闭店铺列表、商品列表、关键词商品列表返回的店铺和商品,以及店铺详情查询过的店铺,会记为“已请求”,有效期 3 天(列表返回的商品,其所属店铺也会一并记为已请求)。在有效期内可以免费调用商品详情、店铺/商品的每日数据和数据趋势、商品评论列表,以及按
shop_id/product_id查询的相关关键词。 - 30 天规则:通过关键词搜索查询过的关键词,30 天内可以免费调用关键词分析、相关关键词和关键词商品列表。
超过有效期后,重新调用对应的扣费接口即可。详见计费规则。
