# Followers list API

> 4 endpoints on 4 platforms return follower lists as the same Account object. The accounts that follow one account, a page at a time, each with its name, handle and follower count. A call costs from…

Canonical page: https://okdata.online/roles/accounts-followers-list/

4 endpoints on 4 platforms return follower lists as the same Account object. The accounts that follow one account, a page at a time, each with its name, handle and follower count. A call costs from $0.0001 to $0.002, each endpoint at its own price; a failed call is free.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Zhihu | [Zhihu user followers](https://okdata.online/apis/zhihu/users/followers/list/) (coming soon) | `GET /v1/zhihu/users/followers/list` | 20 | $0.002 per call · about 20 accounts per page |
| Weibo | [Weibo account followers](https://okdata.online/apis/weibo/users/followers/list/) | `GET /v1/weibo/users/followers/list` | 20 | $0.002 per call · about 20 accounts per page |
| TikTok | [TikTok account followers](https://okdata.online/apis/tiktok/users/followers/list/) | `GET /v1/tiktok/users/followers/list` | 20 | $0.002 per call · about 20 accounts per page |
| X (Twitter) | [X account followers](https://okdata.online/apis/x/users/followers/list/) | `GET /v1/x/users/followers/list` | 200 | $0.0001 per account · at most $0.02 per call |

## The object it returns: [Account](https://okdata.online/docs/objects/account/)

Every endpoint above returns these fields with the same names and types. A field a platform does not show comes back null and is named in meta.unavailable.

| Field | Type | Meaning |
|---|---|---|
| `id` | `string` | Account ID on the platform. |
| `url` | `string` | Profile link. |
| `username` | `string \| null` | Handle, where the platform has one. |
| `name` | `string` | Display name. |
| `bio` | `string \| null` | Profile bio. |
| `avatar_url` | `string \| null` | Avatar image URL. |
| `verified` | `boolean \| null` | Whether the platform shows a verification badge. |
| `followers` | `integer \| null` | Followers. |
| `following` | `integer \| null` | Accounts it follows. |
| `posts` | `integer \| null` | Posts, videos, notes or articles published. |
| `likes` | `integer \| null` | Total likes received, where the platform shows it. |
| `ext` | `object` | Platform-specific extras. Only returned with view=full. |

## The same call on two platforms

Same parameters, same paging, same response shape. Only the path changes.

```bash
# Zhihu
curl -G "https://api.okdata.online/v1/zhihu/users/followers/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'username=zhihuadmin'

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

## What people use it for

- See what kind of accounts follow a competitor.
- Find influential followers of a creator you work with.

## Questions

### Which platforms have it?

Endpoints are added one platform at a time, and the table above lists the ones you can call now. On any other platform, follower lists are not available here; its profile endpoint gives the follower count only.

### Can I get my own followers?

For accounts you own, the platform’s official API is the usual route: X sells reads of your own followers, and the Douyin Open Platform has a fan list for users who have authorised your app.

### What else shows who is around an account?

The profile endpoint gives follower counts, and the comments under an account’s posts show who engages with it, which is often closer to what people want from a follower list.

## Other data types

- [Comments API](https://okdata.online/roles/posts-comments-list/)
- [Trending topics API](https://okdata.online/roles/trends-list/)
- [Comment replies API](https://okdata.online/roles/comments-replies-list/)
- [Hashtag posts API](https://okdata.online/roles/topics-posts-list/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Post detail API](https://okdata.online/roles/posts-get/)
- [Post search API](https://okdata.online/roles/posts-search/)
- [Trending posts API](https://okdata.online/roles/posts-trending/)
- [Account search API](https://okdata.online/roles/accounts-search/)
- [Post metrics API](https://okdata.online/roles/posts-metrics/)
- [Community posts API](https://okdata.online/roles/communities-posts-list/)
- [Ad detail API](https://okdata.online/roles/ads-get/)
- [Advertiser ads API](https://okdata.online/roles/advertisers-ads-list/)
- [Ad search API](https://okdata.online/roles/ads-search/)
- [Transcript API](https://okdata.online/roles/transcripts-get/)
- [Product detail API](https://okdata.online/roles/products-get/)
- [Product reviews API](https://okdata.online/roles/products-reviews-list/)
- [Product search API](https://okdata.online/roles/products-search/)
- [Creator search API](https://okdata.online/roles/creators-search/)
- [Creator profile API](https://okdata.online/roles/creators-get/)
- [Creator audience API](https://okdata.online/roles/creators-audience-get/)