# 粉丝列表接口

> 4 个平台的 4 个接口，用同一个 Account 对象返回粉丝列表。关注某个账号的那些账号，按页返回，每个带昵称、用户名和粉丝数。每次 $0.0001 到 $0.002，各接口按自己的价格计费；失败的调用不扣费。

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

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 知乎 | [知乎用户粉丝列表](https://okdata.online/zh/apis/zhihu/users/followers/list/)（即将上线） | `GET /v1/zhihu/users/followers/list` | 20 | $0.002/次 · 每页约 20 个账号 |
| 微博 | [微博用户粉丝列表](https://okdata.online/zh/apis/weibo/users/followers/list/) | `GET /v1/weibo/users/followers/list` | 20 | $0.002/次 · 每页约 20 个账号 |
| TikTok | [TikTok 账号粉丝列表](https://okdata.online/zh/apis/tiktok/users/followers/list/) | `GET /v1/tiktok/users/followers/list` | 20 | $0.002/次 · 每页约 20 个账号 |
| X（推特） | [X 账号粉丝](https://okdata.online/zh/apis/x/users/followers/list/) | `GET /v1/x/users/followers/list` | 200 | $0.0001/条 · 每次最多 $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/zhihu/users/followers/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'username=zhihuadmin'

# 微博
curl -G "https://api.okdata.online/v1/weibo/users/followers/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=2803301701'
```

## 常见用途

- 看看关注竞品的都是些什么样的账号。
- 找出合作达人粉丝里有影响力的账号。

## 常见问题

### 哪些平台有？

接口按平台逐个上线，现在能调用的都列在上面的表里。其他平台目前拿不到粉丝列表，只能通过账号信息接口拿到粉丝数。

### 能拿自己账号的粉丝吗？

自己的账号，一般走平台官方 API：X 提供读取自己粉丝的接口，抖音开放平台也有粉丝列表接口，适用于授权过你的应用的用户。

### 还有什么办法看出一个账号身边都是谁？

账号信息接口能给粉丝数；一个账号作品下面的评论，能看出到底是谁在和它互动，这往往比粉丝列表更接近你想知道的。

## 其他数据类型

- [评论接口](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-get/)
- [账号作品列表接口](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/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/)