Endpoints by data type
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 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.
Creator profile · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Xiaohongshu (RedNote) | Xiaohongshu PGY creator detail | GET /v1/xiaohongshu/pgy/creators/get | 1 | $0.04 per call |
| Douyin | Douyin Xingtu creator profile | GET /v1/douyin/xingtu/creators/get | 1 | $0.004 per call |
from $0.004 to $0.04 a call, each endpoint at its own price. A call that fails costs nothing.
The object it returns: 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.
# 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.