# Creator audience API 2 endpoints on 2 platforms return the same Audience object. Who follows a creator: the share of each segment by gender, age, region and interest. A call costs from $0.0040 to $0.0400, each endpoint at its own price; a failed call is free. ## Creator audience on each platform | Platform | Endpoint | Path | A page | Returns | Price | | --- | --- | --- | --- | --- | --- | | Douyin | [Douyin Xingtu creator audience](https://dataxapi.com/apis/douyin/xingtu/creators/audience/get.md) | `GET /v1/douyin/xingtu/creators/audience/get` | 1 | Audience | $0.0040 / call | | Xiaohongshu (RedNote) | [Xiaohongshu PGY creator audience profile](https://dataxapi.com/apis/xiaohongshu/pgy/creators/audience/get.md) | `GET /v1/xiaohongshu/pgy/creators/audience/get` | 1 | Audience | $0.0400 / call | Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing. ## The Audience object Every endpoint above returns these fields, with the same names and types. | Field | Type | Description | | --- | --- | --- | | `creator_id` | text | Creator ID | | `measured_at` | time | The day the figures are of, given as the start of that day in China time | | `gender[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `gender[].share` | number | The segment's share of the segments listed, 0 to 1 | | `gender[].count` | integer | Followers in the segment | | `age[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `age[].share` | number | The segment's share of the segments listed, 0 to 1 | | `age[].count` | integer | Followers in the segment | | `province[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `province[].share` | number | The segment's share of the segments listed, 0 to 1 | | `province[].count` | integer | Followers in the segment | | `city[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `city[].share` | number | The segment's share of the segments listed, 0 to 1 | | `city[].count` | integer | Followers in the segment | | `interest[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `interest[].share` | number | The segment's share of the segments listed, 0 to 1 | | `interest[].count` | integer | Followers in the segment | | `device[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `device[].share` | number | The segment's share of the segments listed, 0 to 1 | | `device[].count` | integer | Followers in the segment | | `city_tier[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `city_tier[].share` | number | The segment's share of the segments listed, 0 to 1 | | `city_tier[].count` | integer | Followers in the segment | | `crowd[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `crowd[].share` | number | The segment's share of the segments listed, 0 to 1 | | `crowd[].count` | integer | Followers in the segment | | `purchase_category[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `purchase_category[].share` | number | The segment's share of the segments listed, 0 to 1 | | `purchase_category[].count` | integer | Followers in the segment | | `purchase_amount[].name` | text | Name of the segment, in the platform's words (the two genders come in lower-case English) | | `purchase_amount[].share` | number | The segment's share of the segments listed, 0 to 1 | | `purchase_amount[].count` | integer | Followers in the segment | [The object's own page →](https://dataxapi.com/docs/objects/audience/) ### Which platform fills which field A field an endpoint cannot give is listed in `meta.unavailable` on every answer, so a gap is never a surprise. | Platform | `measured_at` | `gender[].count` | `age[].count` | `province[].count` | `city[].count` | `interest[].count` | `device[].count` | `city_tier[].name` | `city_tier[].share` | `city_tier[].count` | `crowd[].name` | `crowd[].share` | `crowd[].count` | `purchase_category[].name` | `purchase_category[].share` | `purchase_category[].count` | `purchase_amount[].name` | `purchase_amount[].share` | `purchase_amount[].count` | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Douyin | not available | available | available | available | available | available | available | available | available | available | available | available | available | available | available | available | available | available | available | | Xiaohongshu (RedNote) | available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | ## The same call on two platforms Same parameter names, same paging, same answer. Only the path changes. ```bash # Douyin curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/audience/get" \ --data-urlencode "id=6763236383382306828" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" # Xiaohongshu (RedNote): the same call on its own path curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/audience/get" \ --data-urlencode "id=5c0017ef6b58b740c92463fb" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" ``` ### 200 · application/json Douyin Xingtu creator audience: From a response recorded 2026-10-12 21:49 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up. ```jsonc { "code": "ok", "request_id": "25005e75-4c98-42d9-a6dd-afe2a7b8a879", "data": { "item": { "creator_id": "66673485511", "gender": [ { "name": "male", "share": 0.8084018682929753, "count": 20914248 }, { "name": "female", "share": 0.19159813170702464, "count": 4956855 } ], "age": [ { "name": "18-23", "share": 0.02613169810130031, "count": 669976 }, { "name": "24-30", "share": 0.11262389160089727, "count": 2887501 }, // … 3 more ], "province": [ { "name": "福建", "share": 0.034598226662216194, "count": 845507 }, { "name": "香港", "share": 0.001540805252634323, "count": 37654 }, // … 32 more ], "city": [ { "name": "北京", "share": 0.14657726964471665, "count": 751515 }, { "name": "上海", "share": 0.12174096383309756, "count": 624177 }, // … 8 more ], "interest": [ { "name": "二次元", "share": 0.022866163075920397, "count": 471117 }, { "name": "随拍", "share": 0.5770495394947144, "count": 11889089 }, // … 6 more ], "device": [ { "name": "其他", "share": 0.1350657086683392, "count": 3500022 }, { "name": "华为", "share": 0.24915854592413617, "count": 6456564 }, // … 6 more ], "city_tier": [ { "name": "二线", "share": 0.18540551970015773, "count": 4530677 }, { "name": "五线", "share": 0.10928394606430417, "count": 2670526 }, // … 3 more ], "crowd": [ { "name": "Z世代", "share": 0.015066702484682015, "count": 328216 }, { "name": "资深中产", "share": 0.16493764562162405, "count": 3593034 }, // … 6 more ], "purchase_category": [ { "name": "其他", "share": 0.35668521581357804, "count": 3854685 }, { "name": "服饰内衣", "share": 0.20722439582025148, "count": 2239467 }, // … 4 more ], "purchase_amount": [ { "name": "50-100", "share": 0.23128677093645555, "count": 2497497 }, { "name": "0-50", "share": 0.3880473446209439, "count": 4190240 }, // … 3 more ] } }, "warnings": [], "meta": { "capability": "douyin.xingtu.creators.audience.get", "result_status": "complete", "fetched_at": "2026-10-12T21:49:33.000Z", "cached": false, "replayed": false, "unavailable": { "measured_at": "capability" }, "billing": { "amount": "0.004", "currency": "USD", "balance_after": "9.996" } } } ``` ## What comes back - [The Audience object](https://dataxapi.com/docs/objects/audience/): Fields 32, Endpoints that return it 3, Platforms 2 ## Questions about the Creator audience API ### How much does it cost? $0.0040 a call on Douyin; $0.0400 a call on Xiaohongshu (RedNote). You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum. ### Does every platform fill every field? No. 19 of the 32 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in `meta.unavailable` on every answer, never filled with a guess. ### Do I need an account on the platform? No. One DataXAPI key reads all 2 platforms. No platform account and no cookie. ## Other data types [Comment replies API](https://dataxapi.com/roles/comments-replies-list/), [Hashtag posts API](https://dataxapi.com/roles/topics-posts-list/), [Trending topics API](https://dataxapi.com/roles/trends-list/), [Account profile API](https://dataxapi.com/roles/accounts-get/), [Account posts API](https://dataxapi.com/roles/accounts-posts-list/), [Comments API](https://dataxapi.com/roles/posts-comments-list/), [Post detail API](https://dataxapi.com/roles/posts-get/), [Post search API](https://dataxapi.com/roles/posts-search/), [Trending posts API](https://dataxapi.com/roles/posts-trending/), [Account search API](https://dataxapi.com/roles/accounts-search/), [Post metrics API](https://dataxapi.com/roles/posts-metrics/), [Community posts API](https://dataxapi.com/roles/communities-posts-list/), [Ad detail API](https://dataxapi.com/roles/ads-get/), [Advertiser ads API](https://dataxapi.com/roles/advertisers-ads-list/), [Advertiser search API](https://dataxapi.com/roles/advertisers-search/), [Ad library search API](https://dataxapi.com/roles/ads-search/), [Video transcript API](https://dataxapi.com/roles/transcripts-get/), [Followers API](https://dataxapi.com/roles/accounts-followers-list/), [Community profile API](https://dataxapi.com/roles/communities-get/), [Product detail API](https://dataxapi.com/roles/products-get/), [Product reviews API](https://dataxapi.com/roles/products-reviews-list/), [Product search API](https://dataxapi.com/roles/products-search/), [Creator search API](https://dataxapi.com/roles/creators-search/), [Creator profile API](https://dataxapi.com/roles/creators-get/), [Creator metrics API](https://dataxapi.com/roles/creators-metrics/), [Creator posts API](https://dataxapi.com/roles/creators-posts-list/), [All 21 platforms →](https://dataxapi.com/apis/) --- Last checked 2026-10-21 11:10 UTC. Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/roles/creators-audience-get/)