Endpoints by data type
Creator audience API
2 endpoints on 2 platforms return creator audiences as the same Audience object. Who follows a creator, as a creator marketplace reports it: the split by gender, age, region and interests. A call costs from $0.004 to $0.04, each endpoint at its own price; a failed call is free.
Creator audience · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | Douyin Xingtu creator audience | GET /v1/douyin/xingtu/creators/audience/get | 1 | $0.004 per call |
| Xiaohongshu (RedNote) | Xiaohongshu PGY creator audience | GET /v1/xiaohongshu/pgy/creators/audience/get | 1 | $0.04 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: Audience
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 |
|---|---|---|
creator_id | string | The creator ID asked about. |
measured_at | string | null | The day the figures are of, as 00:00 China time. |
gender | AudienceSegment[] | null | By gender. |
age | AudienceSegment[] | null | By age group. |
province | AudienceSegment[] | null | By province. |
city | AudienceSegment[] | null | By city, the largest only. |
interest | AudienceSegment[] | null | By interest. |
device | AudienceSegment[] | null | By phone brand. |
city_tier | AudienceSegment[] | null | By city tier. |
crowd | AudienceSegment[] | null | By the consumer groups the platform sorts people into. |
purchase_category | AudienceSegment[] | null | By the category of goods bought. |
purchase_amount | AudienceSegment[] | null | By the amount spent per order. |
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/audience/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=6763236383382306828'
# Xiaohongshu (RedNote)
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/audience/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=591662306a6a6967b63e7f16'What people use it for
- Check that a creator’s audience matches the buyers you want before you book them.
- Compare two creators with similar follower counts by who those followers are.
Questions
- Which marketplaces have it?
- Only on the marketplaces listed in the table above; audience data from any other marketplace is not available here. Creator search and creator profiles still give followers, engagement and content categories.
- Where does audience data come from?
- From the creator marketplaces, which show it to brands looking for creators. Treat the numbers as the marketplace’s own estimate.
- Can I get my own account’s audience?
- For accounts you own, the platform’s official tools are the usual route; the Douyin Open Platform, for example, has fan data for users who have authorised your app.