Endpoints by data type
Profile API
12 endpoints on 12 platforms return profiles as the same Account object. One account’s public profile as it stands when you call: name, handle, bio, verification, and the counts of followers, following, posts and total likes where the platform shows them. A call costs from $0.0004 to $0.02, each endpoint at its own price; a failed call is free.
Profile · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | Douyin account profile | GET /v1/douyin/users/get | 1 | $0.002 per call |
| Xiaohongshu (RedNote) | Xiaohongshu account profile | GET /v1/xiaohongshu/users/get | 1 | $0.02 per call |
| Weibo account profile | GET /v1/weibo/users/get | 1 | $0.002 per call | |
| TikTok | TikTok account profile | GET /v1/tiktok/users/get | 1 | $0.002 per call |
| X (Twitter) | X account profile | GET /v1/x/users/get | 1 | $0.0004 per account · at most $0.04 per call |
| Instagram account profile | GET /v1/instagram/users/get | 1 | $0.004 per call | |
| Reddit user profile | GET /v1/reddit/users/get | 1 | $0.002 per call | |
| Kuaishou | Kuaishou account profile | GET /v1/kuaishou/users/get | 1 | $0.02 per call |
| Zhihu | Zhihu user profile coming soon | GET /v1/zhihu/users/get | 1 | $0.002 per call |
| WeChat Channels | WeChat Channels account profile | GET /v1/wechat_channels/users/get | 1 | $0.02 per call |
| Bilibili | Bilibili account profile | GET /v1/bilibili/users/get | 1 | $0.002 per call |
| WeChat Official Accounts | Official Account profile | GET /v1/wechat_mp/accounts/get | 1 | $0.02 per call |
from $0.0004 to $0.02 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.
# Douyin
curl -G "https://api.okdata.online/v1/douyin/users/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=MS4wLjABAAAA...'
# Xiaohongshu (RedNote)
curl -G "https://api.okdata.online/v1/xiaohongshu/users/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=5f1234567890abcdef123456'What people use it for
- Check a creator’s follower count and verification before you book them.
- Record competitors’ follower counts every week and chart the growth.
- Turn a column of profile links in a spreadsheet into a table of numbers.
Questions
- Do I need the account ID, or will a handle or link do?
- It depends on the platform. X, TikTok and Instagram take the handle; Douyin and Xiaohongshu take the account ID or a profile link. Each endpoint page lists its parameters.
- Why is a count null?
- Some platforms hide some counts, for some accounts or for all of them; WeChat Channels, for example, can hide followers and total likes. A hidden count comes back null and is named in meta.unavailable.
- Can I see follower growth over time?
- Each call returns the numbers at that moment. Call on a schedule and store each result with its date, and the history is yours; checking 100 accounts once a week is about 430 calls a month.