---
title: "💎 Premium — Brand Audience"
method: GET
path: "/api/brand/v2/{brandId}/audience"
tags: ["Brand"]
---

# 💎 Premium — Brand Audience

`GET /api/brand/v2/{brandId}/audience`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/brand/v2/{brandId}/audience`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/brand/v2/:brandId/audience/get.ts> (a function with typed inputs; its response is checked against the schema)

The brand's own audience breakdown on a given platform — gender and age split, plus the countries, languages and ethnicities its followers skew toward.

Sourced from the brand's own account rather than from the artists matched to it. Mirrors the artist audience endpoints; the brand profile at `GET /api/brand/v2/{brandId}` does not carry this data.

Every weight is a `0`-`1` fraction. `top_ethnicities` is Instagram-only and comes back empty when `platform` is `tiktok` or `youtube`. When no report exists for the brand on the requested platform, `source_platform` is `null` and the lists are empty.

## Path parameters

- `brandId` integer, required: Chartmetric brand ID.

## Query parameters

- `platform` 'instagram' | 'tiktok' | 'youtube': Platform the audience breakdown is sourced from. One of `instagram`, `tiktok`, `youtube`. Defaults to `instagram`. Ethnicity data exists on Instagram only, so `top_ethnicities` is empty for the other platforms.

## Response `200`

Success

- object
  - `obj` object, required
    - `source_platform` string, nullable: Platform the breakdown was sourced from. Null when no report was available.
    - `demographics` object, nullable: Age and gender split. Null when unavailable.
      - `male_percent` number, float, nullable: Share of the audience that is male, 0-1.
      - `female_percent` number, float, nullable: Share of the audience that is female, 0-1.
      - `age_groups` object: Share of the audience per age bracket, keyed by bracket, 0-1.
    - `top_countries` object[], required: Countries the audience is concentrated in, strongest first.
      - `code` string, nullable: Code identifying the country.
      - `name` string, nullable: Display name of the country.
      - `weight` number, float, nullable: Share of the audience, as a 0-1 fraction.
    - `top_languages` object[], required: Languages the audience speaks, strongest first.
      - `code` string, nullable: Code identifying the language.
      - `name` string, nullable: Display name of the language.
      - `weight` number, float, nullable: Share of the audience, as a 0-1 fraction.
    - `top_ethnicities` object[], required: Ethnicity breakdown of the audience. Instagram-only; empty otherwise.
      - `code` string, nullable: Code identifying the ethnicity.
      - `name` string, nullable: Display name of the ethnicity.
      - `weight` number, float, nullable: Share of the audience, as a 0-1 fraction.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)