# 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…

Canonical page: https://okdata.online/roles/accounts-search/

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.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| WeChat Official Accounts | [Official Account search](https://okdata.online/apis/wechat_mp/accounts/search/) | `GET /v1/wechat_mp/accounts/search` | 10 | $0.058 per account · at most $0.58 per call |
| Instagram | [Instagram account search](https://okdata.online/apis/instagram/users/search/) | `GET /v1/instagram/users/search` | 20 | $0.002 per call · about 20 accounts per page |
| Kuaishou | [Kuaishou account search](https://okdata.online/apis/kuaishou/users/search/) | `GET /v1/kuaishou/users/search` | 20 | $0.02 per call · about 20 accounts per page |
| Zhihu | [Zhihu user search](https://okdata.online/apis/zhihu/users/search/) (coming soon) | `GET /v1/zhihu/users/search` | 20 | $0.002 per call · about 20 accounts per page |
| WeChat Channels | [WeChat Channels account search](https://okdata.online/apis/wechat_channels/users/search/) | `GET /v1/wechat_channels/users/search` | 1 | $0.02 per call · about 1 accounts per page |
| Douyin | [Douyin account search](https://okdata.online/apis/douyin/users/search/) | `GET /v1/douyin/users/search` | 30 | $0.002 per call · about 30 accounts per page |
| Xiaohongshu (RedNote) | [Xiaohongshu account search](https://okdata.online/apis/xiaohongshu/users/search/) | `GET /v1/xiaohongshu/users/search` | 20 | $0.02 per call · about 20 accounts per page |
| Weibo | [Weibo account search](https://okdata.online/apis/weibo/users/search/) | `GET /v1/weibo/users/search` | 20 | $0.002 per call · about 20 accounts per page |
| WeChat Search | [WeChat Official Account live search](https://okdata.online/apis/wechat/accounts/search/) | `GET /v1/wechat/accounts/search` | 8 | $0.02 per call · about 8 accounts per page |
| TikTok | [TikTok account search](https://okdata.online/apis/tiktok/users/search/) | `GET /v1/tiktok/users/search` | 30 | $0.002 per call · about 30 accounts per page |
| X (Twitter) | [X account search](https://okdata.online/apis/x/users/search/) | `GET /v1/x/users/search` | 20 | $0.0004 per account · at most $0.008 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
# 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.

## 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/)
- [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/)
- [Followers list API](https://okdata.online/roles/accounts-followers-list/)
- [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/)
