---
title: "Unlock audience report"
method: POST
path: "/api/v2/artist/{uuid}/audience/{platform}/report"
tags: ["Artist"]
---

# Unlock audience report

`POST /api/v2/artist/{uuid}/audience/{platform}/report`

## Path parameters

- `uuid` string, required
- `platform` string, required

## Response `200`

An Artist audience report response

- AudienceReportResponse
  - `type` string
  - `object` Report
    - `top` Top
      - `mentions` CodeWeight[]
        - `code` string
        - `weight` number
      - `hashtags` CodeWeight[]
        - `code` string
        - `weight` number
      - `posts` Post[]
        - `likeCount` integer
        - `commentCount` integer
        - `playCount` integer
        - `viewCount` integer
        - `date` string, date-time
        - `imageUrl` string
        - `url` string
        - `text` string
        - `mentions` string[]
      - `reels` Reel[]
        - `date` string, date-time
        - `url` string
        - `text` string
        - `likeCount` integer
        - `commentCount` integer
        - `playCount` integer
        - `mentions` string[]
    - `audience` Audience2
      - `stats` Stats
        - `followerCount` integer
        - `postCount` integer
        - `viewCount` integer
        - `engagementCount` integer
        - `averageLikesPerPost` number
        - `averageCommentsPerPost` number
        - `averageViewsPerPost` number
        - `engagementRate` number
        - `averageReelsPlays` integer
      - `audienceLike` AudienceDetail
        - `genders` CodeWeight[]
          - `code` string
          - `weight` number
        - `ages` CodeWeight[]
          - `code` string
          - `weight` number
        - `gendersPerAge` GenderPerAge[]
          - `code` string
          - `maleWeight` number
          - `femaleWeight` number
        - `ethnicities` CodeWeight[]
          - `code` string
          - `weight` number
        - `languages` CodeWeight[]
          - `code` string
          - `weight` number
        - `countries` CountryWeight[]
          - `weight` number
          - `countryName` string
          - `countryCode` string
        - `cities` CityWeight[]
          - `weight` number
          - `countryName` string
          - `countryCode` string
          - `region` string
          - `cityName` string
        - `notableUsers` User[]
          - `username` string
          - `fullName` string
          - `followerCount` integer
          - `engagementCount` integer
          - `url` string
          - `imageUrl` string
          - `countryCode` string
          - `countryName` string
        - `types` CodeWeight[]
          - `code` string
          - `weight` number
        - `credibility` number
        - `credibilityClass` string
        - `reachabilities` CodeWeight[]
          - `code` string
          - `weight` number
        - `notableUsersRatio` number
        - `lookalikes` Lookalike[]
          - `username` string
          - `fullName` string
          - `followerCount` integer
          - `engagementCount` integer
          - `url` string
          - `imageUrl` string
          - `countryCode` string
          - `countryName` string
          - `score` number
        - `interests` AffinityWeight[]
          - `name` string
          - `weight` number
          - `affinity` number
        - `brandAffinities` AffinityWeight[]
          - `name` string
          - `weight` number
          - `affinity` number
      - `audienceFollower` AudienceDetail
        - `genders` CodeWeight[]
          - `code` string
          - `weight` number
        - `ages` CodeWeight[]
          - `code` string
          - `weight` number
        - `gendersPerAge` GenderPerAge[]
          - `code` string
          - `maleWeight` number
          - `femaleWeight` number
        - `ethnicities` CodeWeight[]
          - `code` string
          - `weight` number
        - `languages` CodeWeight[]
          - `code` string
          - `weight` number
        - `countries` CountryWeight[]
          - `weight` number
          - `countryName` string
          - `countryCode` string
        - `cities` CityWeight[]
          - `weight` number
          - `countryName` string
          - `countryCode` string
          - `region` string
          - `cityName` string
        - `notableUsers` User[]
          - `username` string
          - `fullName` string
          - `followerCount` integer
          - `engagementCount` integer
          - `url` string
          - `imageUrl` string
          - `countryCode` string
          - `countryName` string
        - `types` CodeWeight[]
          - `code` string
          - `weight` number
        - `credibility` number
        - `credibilityClass` string
        - `reachabilities` CodeWeight[]
          - `code` string
          - `weight` number
        - `notableUsersRatio` number
        - `lookalikes` Lookalike[]
          - `username` string
          - `fullName` string
          - `followerCount` integer
          - `engagementCount` integer
          - `url` string
          - `imageUrl` string
          - `countryCode` string
          - `countryName` string
          - `score` number
        - `interests` AffinityWeight[]
          - `name` string
          - `weight` number
          - `affinity` number
        - `brandAffinities` AffinityWeight[]
          - `name` string
          - `weight` number
          - `affinity` number
      - `brandsAffinity` string[]
      - `interests` string[]
      - `relevantTags` RelevantTag[]
        - `name` string
        - `distance` number
        - `freq` number
  - `errors` Error[]
    - `key` string — Error key
    - `code` integer — Error code
    - `message` string — Error message

## Other responses

- `400` — Invalid request
- `401` — You are not logged in
- `403` — This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access.
- `404` — Artist not found
- `405` — Sandbox only. This operation is not allowed on sandbox environment
- `429` — Maximum quota reached

---

[API](https://skmtc.net/soundcharts/apis/soundcharts-api.md) · [All operations](https://skmtc.net/soundcharts/apis/soundcharts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soundcharts/soundcharts-api/revisions/3c3527dd7996/schema)