# 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 c…

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

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.

## on each platform

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

## The object it returns: [Audience](https://okdata.online/docs/objects/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.

```bash
# 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.

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