问答
数据接口价格里的“按条计费”和“单次最高收费”是什么意思?
简短回答
按条计费是按一次调用返回的结果条数收钱;单次最高收费把一次调用的费用封顶在一整页。okdata 里按条计费的接口是公众号搜索:每返回一个公众号 $0.058,最少算一条,单次最多 $0.58。其他接口都按次计费,价格本身就是最高收费。
数据接口的计价单位大体两种。按次计费:一次请求不管返回多少都是同一个价。按条计费:响应里每有一条结果就收一份钱,所以找到三条的请求比找到十条的便宜。X 官方 API 就是后一种,它的按用量计费页面写的是按返回的帖子或用户计费。按条计费必须有个上限,不然调用之前你没法知道这次要花多少钱。这个上限就是单次最高收费。
okdata 怎么用这两种计价
| 按次计费的接口(几乎全部) | 按条计费:公众号搜索 | |
|---|---|---|
| 价格 | 每次调用,比如抖音搜索一页 $0.02 | 每返回一个公众号 $0.058 |
| 最少计几条 | 不适用 | 1 条,一个都没搜到也算 1 条 |
| 单次最高收费 | 等于价格 | $0.58,即一整页 10 个公众号 |
| 翻页 | 每页一次调用 | 每页照样按返回的公众号数计费 |
每个接口的页面都会在价格旁边标明计价单位。目前接口目录里按条计费的只有公众号搜索这一个。
算几笔账
| 搜索 | 返回的公众号数 | 收费 |
|---|---|---|
query=36氪,第一页是满的 |
10 | $0.58 |
| 一个精确的公众号名,匹配到 3 个 | 3 | 3 × $0.058 |
| 一个搜不到的名字 | 0 | $0.058(最少算 1 条) |
| 20 个品牌名,按最坏情况做预算 | 最多 200 | 最多 $11.60 |
最高收费和余额
单次最高收费是一次调用可能花掉的钱,所以余额要先够付它。不够的时候,按次计费的接口会返回 insufficient_balance,不扣费。公众号搜索的处理宽松一些:余额不够一整页时,第一页按余额能付的条数返回,这一页缩短了,也就没有下一页。充值之后就恢复整页返回。
示例
直接从响应里看这次调用实际扣了多少:
curl -s -G "https://api.okdata.online/v1/wechat_mp/accounts/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'query=36氪' \
--data-urlencode 'fields=id,name' \
| jq '{charged: .meta.billing.amount, accounts: (.data.items | length), balance: .meta.billing.balance_after}'
给一批任务做预算,用调用次数乘以单次最高收费,这就是这批任务最多会花的钱。实际账单通常更低,因为按精确名称搜,很少能填满一整页。
限制
- 请求到了数据源的调用,返回为空、
not_found、数据源出错或超时,都照常计费,按条计费的接口算一条,也就是 $0.058。参数错误这类还没请求数据源就被拦下的不扣费。 - 因为最少算一条,100 个名字全部搜不到,也要付 100 × $0.058。搜之前先把名单清洗一遍。
- 24 小时内用同一个
Idempotency-Key重试,返回的是存好的结果,不会再扣一次。
想把其他供应商的各种计价单位换算成可比的数字,见按次、按条、按积分报价的数据接口怎么比价。要找公众号本身,见怎么查公众号的 biz 和原始 ID。
资料来源
这个问题出现过的地方(读取于 2026-11-12)
更新于