# 数据接口价格里的“按条计费”和“单次最高收费”是什么意思？

> 数据接口按次计费和按条计费的区别：按条计费的调用怎么按返回结果收钱，为什么每次调用有最高收费，以及两种计价方式下怎么做预算。

网页版：https://okdata.online/zh/answers/per-item-price-max-charge/

**简短回答：**按条计费是按一次调用返回的结果条数收钱；单次最高收费把一次调用的费用封顶在一整页。okdata 里按条计费的接口是公众号搜索：每返回一个公众号 $0.058，最少算一条，单次最多 $0.58。其他接口都按次计费，价格本身就是最高收费。

数据接口的计价单位大体两种。按次计费：一次请求不管返回多少都是同一个价。按条计费：响应里每有一条结果就收一份钱，所以找到三条的请求比找到十条的便宜。X 官方 API 就是后一种，它的按用量计费页面写的是按返回的帖子或用户计费。按条计费必须有个上限，不然调用之前你没法知道这次要花多少钱。这个上限就是单次最高收费。

## okdata 怎么用这两种计价

| | 按次计费的接口（几乎全部） | 按条计费：[公众号搜索](/zh/apis/wechat_mp/accounts/search/) |
|---|---|---|
| 价格 | 每次调用，比如抖音搜索一页 $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`，不扣费。公众号搜索的处理宽松一些：余额不够一整页时，第一页按余额能付的条数返回，这一页缩短了，也就没有下一页。充值之后就恢复整页返回。

## 示例

直接从响应里看这次调用实际扣了多少：

```bash
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` 重试，返回的是存好的结果，不会再扣一次。

想把其他供应商的各种计价单位换算成可比的数字，见[按次、按条、按积分报价的数据接口怎么比价](/zh/answers/compare-data-api-pricing-units/)。要找公众号本身，见[怎么查公众号的 biz 和原始 ID](/zh/answers/find-wechat-official-account-id/)。

## 用到的接口

- [公众号搜索](https://okdata.online/zh/apis/wechat_mp/accounts/search/) `wechat_mp.accounts.search`：$0.058/条 · 每次最多 $0.58

## 更多微信公众号内容

- [微信公众号 API](https://okdata.online/zh/apis/wechat_mp/)
- [公众号 API Python 教程：把文章转成 Markdown 给 RAG 用（2026）](https://okdata.online/zh/guides/wechat-official-account-api-python/)
- [怎么拿到一个公众号的历史文章和全文](https://okdata.online/zh/guides/wechat-official-account-articles/)
- [公众号文章数据 API 多少钱？](https://okdata.online/zh/answers/wechat-official-account-api-price/)
- [为什么 ChatGPT、Claude 打不开公众号文章链接？怎么让 AI 读到全文？](https://okdata.online/zh/answers/ai-read-wechat-article-link/)
- [数据接口有按次、按条、按积分、按流量计费的，怎么放在一起比价？](https://okdata.online/zh/answers/compare-data-api-pricing-units/)
- [怎么不登录导出一个公众号的全部历史文章？](https://okdata.online/zh/answers/export-wechat-official-account-articles/)
- [数据接口调用失败或者没搜到结果，要扣钱吗？](https://okdata.online/zh/answers/failed-api-calls-charged-refund/)
- [怎么查一个公众号的 biz 和原始 ID（gh_ 开头）？](https://okdata.online/zh/answers/find-wechat-official-account-id/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [社媒数据 MCP 服务器：自己部署还是用托管的](https://okdata.online/zh/compare/social-media-data-mcp-servers/)
- [公众号文章和阅读数接口有哪些？官方接口、第三方 API、开源工具、数据平台 4 类方案怎么选（2026）](https://okdata.online/zh/compare/wechat-article-data-apis/)
- [获取微信公众号数据的几种办法：官方接口、RSS 桥接和数据接口](https://okdata.online/zh/compare/wechat-official-account-data-apis/)
- [让 AI 读小红书、抖音、公众号的 MCP 有哪些？开源自部署、浏览器自动化、托管 3 类怎么选（Claude、Cursor、豆包）](https://okdata.online/zh/compare/xiaohongshu-douyin-wechat-mcp-servers/)

## 资料来源

- [X API 按用量计费：按返回的资源数收费](https://docs.x.com/x-api/getting-started/pricing) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://devcommunity.x.com/t/are-2-tweets-search-requests-charged-per-request-per-post-returned-or-both/258982
- https://devcommunity.x.com/t/i-was-charged-for-4k-posts-while-ive-only-received-around-500-posts/256385

更新于 2026-11-12
