# 数据接口充的余额不用完会过期吗？

> 社媒数据接口的预充值余额会不会过期，充值前该问清楚哪几件事，以及一笔小额余额够微博、小红书任务用多久。

网页版：https://okdata.online/zh/answers/data-api-balance-expire/

**简短回答：**在 okdata 上不会过期：充进去的钱一直留在账户里，直到你用掉为止，没有按月清零。这对不常用的任务很合适，比如每季度查 200 次小红书（$4.00），或者一整年每小时存一次微博热搜（$17.52）。不少接口的额度是会过期的，在哪儿充值都先问清楚。

担心这个很正常。V2EX 上就有人发现 [AI 接口的余额还没用就过期了](https://www.v2ex.com/t/1099592)，按套餐卖的数据工具也大多是每月额度清零。对一年只买几次社媒数据的团队来说，过期规则有时比单价还要紧。

## 这里是怎么算的

- 余额以美元计，不用完就一直在。没有套餐、没有月费，也不清零。
- 每次调用从余额里扣这次的价格；失败的调用不扣。
- 新 key 自带 $0.10，先试着用。

## 一笔小余额能用多久

| 任务 | 接口 | 次数 | 费用 |
|---|---|---|---|
| 每季度品牌巡检，搜 200 次 | [小红书笔记搜索](/zh/apis/xiaohongshu/notes/search/) | 200 | $4.00 |
| 同样的巡检做满四个季度 | 小红书笔记搜索 | 800 | $16.00 |
| 一整年每小时存一次微博热搜 | [微博热搜](/zh/apis/weibo/trends/list/) | 8760 | $17.52 |

既然不会过期，为一年的零散任务一次充够也没问题，不用赶在某个日期前花完。

## 随时看剩多少

```bash
# 余额，以及当前 key 的频率限制
curl -s "https://api.okdata.online/v1/account" -H "Authorization: Bearer $OKDATA_API_KEY"

# 每次调用也会返回扣费后的余额
curl -s "https://api.okdata.online/v1/weibo/trends/list" -H "Authorization: Bearer $OKDATA_API_KEY" \
  | jq '.meta.billing'
```

## 在任何一家充值前，问这四件事

1. 付费充值的余额会不会过期，多久过期？
2. 赠送或活动额度是不是单独计算、过期更早，扣费时是不是先扣它？
3. 每月套餐里没用完的额度能不能结转，还是直接清零？
4. 没用完的余额能不能退，怎么退？

okdata 关于未用余额退款的规定写在服务条款里，条款目前还是草稿；如果打算一次充比较大的金额，先发邮件问 hello@okdata.online。价格和哪些情况不收费，都在[价格页](/zh/pricing/)。

## 用到的接口

- [微博热搜](https://okdata.online/zh/apis/weibo/trends/list/) `weibo.trends.list`：$0.002/次 · 每页约 50 条榜单
- [小红书笔记搜索](https://okdata.online/zh/apis/xiaohongshu/notes/search/) `xiaohongshu.notes.search`：$0.02/次 · 每页约 20 篇笔记

更新于 2026-11-12