Endpoints by data type
Account search API
11 endpoints on 11 platforms return account search results as the same Account object. Accounts that match a name or keyword, as the platform’s own search finds them, each with the ID you need for every other call about that account. A call costs from $0.0004 to $0.058, each endpoint at its own price; a failed call is free.
Account search · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| WeChat Official Accounts | Official Account search | GET /v1/wechat_mp/accounts/search | 10 | $0.058 per account · at most $0.58 per call |
| Instagram account search | GET /v1/instagram/users/search | 20 | $0.002 per call · about 20 accounts per page | |
| Kuaishou | Kuaishou account search | GET /v1/kuaishou/users/search | 20 | $0.02 per call · about 20 accounts per page |
| Zhihu | Zhihu user search coming soon | GET /v1/zhihu/users/search | 20 | $0.002 per call · about 20 accounts per page |
| WeChat Channels | WeChat Channels account search | GET /v1/wechat_channels/users/search | 1 | $0.02 per call · about 1 accounts per page |
| Douyin | Douyin account search | GET /v1/douyin/users/search | 30 | $0.002 per call · about 30 accounts per page |
| Xiaohongshu (RedNote) | Xiaohongshu account search | GET /v1/xiaohongshu/users/search | 20 | $0.02 per call · about 20 accounts per page |
| Weibo account search | GET /v1/weibo/users/search | 20 | $0.002 per call · about 20 accounts per page | |
| WeChat Search | WeChat Official Account live search | GET /v1/wechat/accounts/search | 8 | $0.02 per call · about 8 accounts per page |
| TikTok | TikTok account search | GET /v1/tiktok/users/search | 30 | $0.002 per call · about 30 accounts per page |
| X (Twitter) | X account search | GET /v1/x/users/search | 20 | $0.0004 per account · at most $0.008 per call |
from $0.0004 to $0.058 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.
# WeChat Official Accounts
curl -G "https://api.okdata.online/v1/wechat_mp/accounts/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'query=36氪'
# Instagram
curl -G "https://api.okdata.online/v1/instagram/users/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'query=nike'What people use it for
- Turn a list of brand names into account IDs you can track.
- Find the accounts in a niche by keyword before you look at their posts.
- Look up a WeChat Official Account’s original ID from its name.
Questions
- Can I search by topic as well as by name?
- It depends on the platform’s own search. Kuaishou and Official Account search take any keyword; WeChat Channels search usually returns the one account whose name matches best, so it suits names you already know.
- How is it charged?
- Most of these endpoints charge per call. Official Account search charges per account returned, so check the unit in the table above before you run a long list of names.
- What do I do with the results?
- Keep each account’s id. Pass it to the profile endpoint for counts and bio, or to the account posts endpoint for what the account has published.