开发文档

从零到第一次调用，这里就够了。

快速开始

注册即送 15 积分，够你跑通全流程。在控制台创建密钥后，把示例里的 sk_live_… 换掉即可。

1注册账号并登录控制台
2在「API 密钥」里创建一个密钥（明文只显示一次）
3用下面的示例发起第一次调用

bash

curl --location 'https://api.xdatafly.com/v1/amazon/reviews?asin=B0DXK317FN&page_count=1&sort=recent&star=all_stars&site=amz_us' \
  --header 'Accept: application/json' \
  --max-time 120 \
  --header 'secret-key: sk_live_xxxxxxxxxxxxxxxx'

认证方式

在 secret-key 请求头里带上密钥，形如 sk_live_…，创建时只展示一次。

http

secret-key: sk_live_xxxxxxxxxxxxxxxx

接口地址

text

https://api.xdatafly.com

接口列表

接口端点	价格
GET /v1/amazon/reviews 亚马逊评论接口	1/ 每页	详情 →
GET /v1/google/search 谷歌搜索接口待开放	2/ 每次	待开放

亚马逊评论请求

bash

curl --location 'https://api.xdatafly.com/v1/amazon/reviews?asin=B0DXK317FN&page_count=1&sort=recent&star=all_stars&site=amz_us' \
  --header 'Accept: application/json' \
  --max-time 120 \
  --header 'secret-key: sk_live_xxxxxxxxxxxxxxxx'

哪些查询会被拒绝

site:、inurl:、intitle:、filetype: 等高级操作符会返回 40003。这类查询成本显著更高，为保证服务稳定暂不开放。

返回信封

无论成功还是失败，返回结构完全一致。

json

{
  "code": 0,
  "message": "ok",
  "request_id": "req_7f3a9c21",
  "data": {},
  "usage": {
    "credits": 1,
    "balance": 999
  },
  "duration_ms": 2140
}

code — 业务码，0 表示成功
usage.credits — 本次实际扣费（失败为 0）
usage.balance — 结算后的可用余额

计费规则

只有 status 为 SUCCESS 的调用才扣积分。返回体里始终给出本次扣费积分与剩余余额，方便你对账而不必猜。

冻结

请求发出前按参数上限预扣积分

执行

调用上游并解析结果

结算

成功才真正扣费，失败全额解冻

延迟与超时

亚马逊评论需实时抓取 Amazon 页面，单页通常 5–40 秒，高峰期可能更久。请把客户端超时设为 ≥60 秒（curl 用 --max-time，Python 用 timeout）。默认 30 秒会误判为失败；而超时或上游失败都会全额解冻积分，不计费。

错误码

业务码	HTTP	含义	是否计费
0	200	调用成功	计费
40001	400	参数缺失或格式错误（如 q 为空）	不计费
40002	400	参数超出范围（num 需在 1-20，page_count 在 1-10）	不计费
40003	400	查询含 site: / inurl: / filetype: 等被禁用操作符	不计费
40100	401	缺少或无效的 secret-key	不计费
40101	401	密钥被停用或已过期	不计费
40301	403	该接口暂未开放	不计费
40201	402	可用积分不足以支付本次预扣	不计费
42900	429	超出每分钟请求上限	不计费
50001	502	上游数据源不可用，已自动解冻积分	不计费
50002	500	上游响应解析失败，已自动解冻积分	不计费
50000	500	服务内部异常	不计费

限流

每个密钥有每分钟请求上限（默认 60）。响应头会带 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset。超限返回 HTTP 429 并带 Retry-After。

X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-After

幂等

可自行传入 X-Request-Id。24 小时内重复同一个 id 会直接返回上次的结果，不会重复扣费。

准备好接入了吗

注册即送 15 积分，无需绑卡。

获取 API 密钥