Endpoints by data type
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 $0.0001 to $0.002, each endpoint at its own price; a failed call is free.
Followers list · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Zhihu | Zhihu user followers coming soon | GET /v1/zhihu/users/followers/list | 20 | $0.002 per call · about 20 accounts per page |
| Weibo account followers | GET /v1/weibo/users/followers/list | 20 | $0.002 per call · about 20 accounts per page | |
| TikTok | TikTok account followers | GET /v1/tiktok/users/followers/list | 20 | $0.002 per call · about 20 accounts per page |
| X (Twitter) | X account followers | GET /v1/x/users/followers/list | 200 | $0.0001 per account · at most $0.02 per call |
from $0.0001 to $0.002 a call, each endpoint at its own price. A call that fails costs nothing.
The object it returns: 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.
# 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.