💎 Premium — Brand Audience

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
Type: integer
min:
0
max:
2147483647
required

Chartmetric brand ID.

Query Parameters

platform
Type: string enum

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.
values
- instagram
- tiktok
- youtube

Responses

application/json

get/api/brand/v2/{brandId}/audience

curl https://api.chartmetric.com/api/brand/v2/1/audience \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "source_platform": "instagram",
    "demographics": {
      "male_percent": 0.634776,
      "female_percent": 0.365224,
      "age_groups": {
        "13-17": 0.046817,
        "18-24": 0.309867,
        "25-34": 0.418992,
        "35-44": 0.160466,
        "45-64": 0.063359,
        "65+": 0.000498
      }
    },
    "top_countries": [
      {
        "code": "US",
        "name": "United States",
        "weight": 0.733002
      },
      {
        "code": "MX",
        "name": "Mexico",
        "weight": 0.032383
      }
    ],
    "top_languages": [
      {
        "code": "en",
        "name": "English",
        "weight": 0.738099
      }
    ],
    "top_ethnicities": [
      {
        "code": "white",
        "name": "White",
        "weight": 0.51
      }
    ]
  }
}

Success