# 账号信息接口

> 12 个平台的 12 个接口，用同一个 Account 对象返回账号信息。调用那一刻某个账号的公开主页信息：昵称、用户名、简介、认证，以及平台展示的粉丝数、关注数、作品数和累计获赞。每次 $0.0004 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/accounts-get/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音账号信息](https://okdata.online/zh/apis/douyin/users/get/) | `GET /v1/douyin/users/get` | 1 | $0.002/次 |
| 小红书 | [小红书博主信息](https://okdata.online/zh/apis/xiaohongshu/users/get/) | `GET /v1/xiaohongshu/users/get` | 1 | $0.02/次 |
| 微博 | [微博账号信息](https://okdata.online/zh/apis/weibo/users/get/) | `GET /v1/weibo/users/get` | 1 | $0.002/次 |
| TikTok | [TikTok 账号信息](https://okdata.online/zh/apis/tiktok/users/get/) | `GET /v1/tiktok/users/get` | 1 | $0.002/次 |
| X（推特） | [X 账号信息](https://okdata.online/zh/apis/x/users/get/) | `GET /v1/x/users/get` | 1 | $0.0004/条 · 每次最多 $0.04 |
| Instagram | [Instagram 账号信息](https://okdata.online/zh/apis/instagram/users/get/) | `GET /v1/instagram/users/get` | 1 | $0.004/次 |
| Reddit | [Reddit 用户资料](https://okdata.online/zh/apis/reddit/users/get/) | `GET /v1/reddit/users/get` | 1 | $0.002/次 |
| 快手 | [快手账号信息](https://okdata.online/zh/apis/kuaishou/users/get/) | `GET /v1/kuaishou/users/get` | 1 | $0.02/次 |
| 知乎 | [知乎用户资料](https://okdata.online/zh/apis/zhihu/users/get/)（即将上线） | `GET /v1/zhihu/users/get` | 1 | $0.002/次 |
| 微信视频号 | [视频号账号信息](https://okdata.online/zh/apis/wechat_channels/users/get/) | `GET /v1/wechat_channels/users/get` | 1 | $0.02/次 |
| B站 | [B站用户资料](https://okdata.online/zh/apis/bilibili/users/get/) | `GET /v1/bilibili/users/get` | 1 | $0.002/次 |
| 微信公众号 | [公众号资料](https://okdata.online/zh/apis/wechat_mp/accounts/get/) | `GET /v1/wechat_mp/accounts/get` | 1 | $0.02/次 |

## 返回的对象：[Account](https://okdata.online/zh/docs/objects/account/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `id` | `string` | 账号在平台上的 ID。 |
| `url` | `string` | 主页链接。 |
| `username` | `string \| null` | 用户名（平台有的话）。 |
| `name` | `string` | 昵称。 |
| `bio` | `string \| null` | 简介。 |
| `avatar_url` | `string \| null` | 头像图片地址。 |
| `verified` | `boolean \| null` | 平台是否显示认证标识。 |
| `followers` | `integer \| null` | 粉丝数。 |
| `following` | `integer \| null` | 关注数。 |
| `posts` | `integer \| null` | 发布的作品、笔记或文章数。 |
| `likes` | `integer \| null` | 累计获赞（平台展示的话）。 |
| `ext` | `object` | 平台特有字段，只在 view=full 时返回。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
curl -G "https://api.okdata.online/v1/douyin/users/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=MS4wLjABAAAA...'

# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/users/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=5f1234567890abcdef123456'
```

## 常见用途

- 投放前核对达人的粉丝数和认证情况。
- 每周记录竞品账号的粉丝数，画出增长曲线。
- 把表格里的一列主页链接，变成一张数字表。

## 常见问题

### 要账号 ID，还是用户名或链接也行？

看平台。X、TikTok 和 Instagram 用用户名；抖音和小红书用账号 ID 或主页链接。每个接口页都列了参数。

### 为什么有的数字是 null？

有些平台会隐藏部分数字，有的只对个别账号，有的对所有账号；比如视频号可能隐藏粉丝数和累计获赞。被隐藏的数字返回 null，并在 meta.unavailable 里注明。

### 能看粉丝增长趋势吗？

每次调用返回的是那一刻的数字。定时调用，把每次结果连同日期存下来，历史就有了；100 个账号每周查一次，一个月大约 430 次调用。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)