Endpoints by data type
Creator search API
2 endpoints on 2 platforms return creators as the same Creator object. Creators on a platform’s official creator marketplace, found by what they post or by name and filtered by followers and more: each with followers, engagement, median views or reads, content categories and listed rates. A call costs from $0.004 to $0.04, each endpoint at its own price; a failed call is free.
Creator search · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | Douyin Xingtu creator search | GET /v1/douyin/xingtu/creators/search | 20 | $0.004 per call · about 20 creators per page |
| Xiaohongshu (RedNote) | Xiaohongshu PGY creator search | GET /v1/xiaohongshu/pgy/creators/search | 20 | $0.04 per call · about 20 creators per page |
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.
# Douyin
curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'query=户外'
# Xiaohongshu (RedNote)
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/search" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'query=户外'What people use it for
- Build a shortlist of camping creators with 10,000 to 100,000 followers.
- Compare listed rates with median views before you send briefs.
- Find creators whose recent engagement rate is above a threshold.
Questions
- How is this different from account search?
- Account search returns profiles from the app. Creator search returns marketplace data: engagement rate, median views, content categories and listed rates for sponsored work.
- Are the rates what I will pay?
- They are the prices listed on the marketplace, in yuan, with whether each kind of work is open. The deal itself happens on the marketplace, and rates are null when it hides them.
- Do I need a Xingtu or PGY account?
- No. One API key is enough: you never log in to the marketplace, and no marketplace account of yours is involved.