# Creator profile API

> 2 endpoints on 2 platforms return creator profiles as the same Creator object. One creator’s profile on a platform’s creator marketplace: followers, median reads or views and engagements, content t…

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

2 endpoints on 2 platforms return creator profiles as the same Creator object. One creator’s profile on a platform’s creator marketplace: followers, median reads or views and engagements, content tags, and the rates listed for sponsored work. A call costs from $0.004 to $0.04, each endpoint at its own price; a failed call is free.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Xiaohongshu (RedNote) | [Xiaohongshu PGY creator detail](https://okdata.online/apis/xiaohongshu/pgy/creators/get/) | `GET /v1/xiaohongshu/pgy/creators/get` | 1 | $0.04 per call |
| Douyin | [Douyin Xingtu creator profile](https://okdata.online/apis/douyin/xingtu/creators/get/) | `GET /v1/douyin/xingtu/creators/get` | 1 | $0.004 per call |

## The object it returns: [Creator](https://okdata.online/docs/objects/creator/)

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` | The marketplace's creator ID; the other marketplace endpoints take it. |
| `url` | `string` | The creator's page on the marketplace. |
| `account_id` | `string \| null` | The creator's own account ID on the platform, where the marketplace gives it: on Douyin the sec_uid (MS4w…) that douyin.users.get takes, on Xiaohongshu the user ID. |
| `username` | `string \| null` | Handle on the platform, where given. |
| `name` | `string` | Display name. |
| `avatar_url` | `string \| null` | Avatar image URL. |
| `location` | `string \| null` | Where the creator says they are. |
| `gender` | `string \| null` | The creator's gender as the marketplace lists it. |
| `followers` | `integer \| null` | Followers. |
| `categories` | `string[] \| null` | Content categories in the marketplace’s own words. |
| `engagement_rate` | `number \| null` | Interactions per view of recent posts, 0 to 1 (0.038 is 3.8%). |
| `median_views` | `integer \| null` | Median views or reads of recent everyday posts. |
| `median_engagements` | `integer \| null` | Median interactions (likes, comments, saves, shares) of recent everyday posts. |
| `rates` | `Rate[] \| null` | Published rates for sponsored work; null when the marketplace hides them. |
| `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
# Xiaohongshu (RedNote)
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=5dfa1ee20000000001001cb3'

# Douyin
curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=6763236383382306828'
```

## What people use it for

- Refresh the numbers of the creators on your shortlist before you book.
- Check a creator’s listed rates for an image post and a video post.

## Questions

### Which ID does it take?

The marketplace’s own creator ID, from creator search. It is not the creator’s account ID on the platform, which comes back separately as account_id.

### What do the medians cover?

Recent everyday posts, as the marketplace reports them. A median says more about a typical post than an average, which one viral post can pull up.

### Which marketplaces have it?

Endpoints are added one marketplace at a time, and the table above lists the ones you can call now. Creator search already returns most of the same fields.

## 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/)
- [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 audience API](https://okdata.online/roles/creators-audience-get/)