# Audience distribution fields and sources

Audience distribution fields and sources. Follow concrete contracts, examples and reviewable steps using Douyin, Xiaohongshu (RedNote).

Canonical page: https://datanavoapi.com/en/docs/objects/audience/

This is a local simulation. Program-generated samples are not live platform data and do not establish provider availability.

## Object and null semantics

Audience distribution (audience) is referenced by 3 capabilities across 2 platforms. Shared names help organize records; they do not guarantee identical data coverage.

Preserve identifiers as strings. Null, absent, zero and empty arrays mean different things. Fields under ext are platform extensions, not universal guarantees.

## Complete field paths

Field facts come from the preserved public contracts. The table merges platform extensions and identifies the platforms whose contracts declare each field.

| Field path | Type | Requirement | Declaring platforms |

| --- | --- | --- | --- |

| creator_id | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| measured_at | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| gender | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| gender[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| gender[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| gender[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| age | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| age[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| age[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| age[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| province | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| province[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| province[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| province[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| interest | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| interest[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| interest[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| interest[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| device | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| device[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| device[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| device[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city_tier | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city_tier[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city_tier[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| city_tier[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| crowd | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| crowd[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| crowd[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| crowd[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_category | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_category[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_category[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_category[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_amount | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_amount[].name | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_amount[].share | number \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| purchase_amount[].count | integer \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| approximate | array \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| approximate[].field | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| approximate[].kind | string \| null | Optional in contract | Douyin, Xiaohongshu (RedNote) |

| ext | object | Optional in contract | Douyin, Xiaohongshu (RedNote) |

## Capabilities returning this object

| Capability | Object | Shape | Pagination |

| --- | --- | --- | --- |

| douyin.index.creators.audience.get | Audience distribution | item | No cursor |

| douyin.xingtu.creators.audience.get | Audience distribution | item | No cursor |

| xiaohongshu.pgy.creators.audience.get | Audience distribution | item | No cursor |

- [Douyin trend-index creator follower profile](https://datanavoapi.com/en/apis/douyin/index/creators/audience/get/)
- [Douyin Xingtu creator audience](https://datanavoapi.com/en/apis/douyin/xingtu/creators/audience/get/)
- [Xiaohongshu PGY creator audience profile](https://datanavoapi.com/en/apis/xiaohongshu/pgy/creators/audience/get/)

## Related pages

- [Douyin trend-index creator follower profile](https://datanavoapi.com/en/apis/douyin/index/creators/audience/get/)
- [Douyin Xingtu creator audience](https://datanavoapi.com/en/apis/douyin/xingtu/creators/audience/get/)
- [Xiaohongshu PGY creator audience profile](https://datanavoapi.com/en/apis/xiaohongshu/pgy/creators/audience/get/)
- [Which APIs support Xingtu creator research?](https://datanavoapi.com/en/answers/douyin-xingtu-api/)
- [Which APIs support a RedNote creator shortlist?](https://datanavoapi.com/en/answers/xiaohongshu-kol-selection-api/)
- [Compare Xingtu creator rates and audiences](https://datanavoapi.com/en/guides/douyin-xingtu-creator-rates/)
- [Creator shortlisting workflow](https://datanavoapi.com/en/skills/creators/)

[中文](https://datanavoapi.com/docs/objects/audience/)
