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

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

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.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | [Douyin account profile](https://okdata.online/apis/douyin/users/get/) | `GET /v1/douyin/users/get` | 1 | $0.002 per call |
| Xiaohongshu (RedNote) | [Xiaohongshu account profile](https://okdata.online/apis/xiaohongshu/users/get/) | `GET /v1/xiaohongshu/users/get` | 1 | $0.02 per call |
| Weibo | [Weibo account profile](https://okdata.online/apis/weibo/users/get/) | `GET /v1/weibo/users/get` | 1 | $0.002 per call |
| TikTok | [TikTok account profile](https://okdata.online/apis/tiktok/users/get/) | `GET /v1/tiktok/users/get` | 1 | $0.002 per call |
| X (Twitter) | [X account profile](https://okdata.online/apis/x/users/get/) | `GET /v1/x/users/get` | 1 | $0.0004 per account · at most $0.04 per call |
| Instagram | [Instagram account profile](https://okdata.online/apis/instagram/users/get/) | `GET /v1/instagram/users/get` | 1 | $0.004 per call |
| Reddit | [Reddit user profile](https://okdata.online/apis/reddit/users/get/) | `GET /v1/reddit/users/get` | 1 | $0.002 per call |
| Kuaishou | [Kuaishou account profile](https://okdata.online/apis/kuaishou/users/get/) | `GET /v1/kuaishou/users/get` | 1 | $0.02 per call |
| Zhihu | [Zhihu user profile](https://okdata.online/apis/zhihu/users/get/) (coming soon) | `GET /v1/zhihu/users/get` | 1 | $0.002 per call |
| WeChat Channels | [WeChat Channels account profile](https://okdata.online/apis/wechat_channels/users/get/) | `GET /v1/wechat_channels/users/get` | 1 | $0.02 per call |
| Bilibili | [Bilibili account profile](https://okdata.online/apis/bilibili/users/get/) | `GET /v1/bilibili/users/get` | 1 | $0.002 per call |
| WeChat Official Accounts | [Official Account profile](https://okdata.online/apis/wechat_mp/accounts/get/) | `GET /v1/wechat_mp/accounts/get` | 1 | $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
# 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.

## 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/)
- [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/)
- [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/)
