Audience object

A creator's followers by gender, age, place, interest, device and shopping. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

Field	Type	From view	Description
`creator_id`	string	compact	The creator ID asked about.
`measured_at`	string \| null	compact	The day the figures are of, as 00:00 China time.
`gender`	AudienceSegment[] \| null	compact	By gender.
`age`	AudienceSegment[] \| null	compact	By age group.
`province`	AudienceSegment[] \| null	compact	By province.
`city`	AudienceSegment[] \| null	compact	By city, the largest only.
`interest`	AudienceSegment[] \| null	compact	By interest.
`device`	AudienceSegment[] \| null	compact	By phone brand.
`city_tier`	AudienceSegment[] \| null	compact	By city tier.
`crowd`	AudienceSegment[] \| null	compact	By the consumer groups the platform sorts people into.
`purchase_category`	AudienceSegment[] \| null	compact	By the category of goods bought.
`purchase_amount`	AudienceSegment[] \| null	compact	By the amount spent per order.
`ext`	object	full	Platform-specific extras. Only returned with view=full. · only with view=full

AudienceSegment

Field	Type	Description
`name`	string	The segment, in the platform's words (genders come as lower-case English).
`share`	number \| null	The segment's share of the segments listed, 0 to 1.
`count`	integer \| null	Followers in the segment.

Example · douyin

{
  "creator_id": null,
  "measured_at": null,
  "gender": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "age": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "province": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "city": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "interest": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "device": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "city_tier": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "crowd": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "purchase_category": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ],
  "purchase_amount": [
    {
      "name": null,
      "share": null,
      "count": null
    }
  ]
}

Audience object

AudienceSegment

Endpoints that return a Audience

Connect once, then just ask.