--- 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` ## Request - Base URL: `https://developers.soundcharts.com` (the document declares no server; this is the origin it was published from) - URL: `https://developers.soundcharts.com/api/v2/artist/{uuid}/audience/{platform}/report` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `uuid` string, required - `platform` string, required ## Response `200` An Artist audience report response - AudienceReportResponse - `type` string - `object` Report - `userProfile` UserProfile - `accountType` string - `ageGroup` string - `description` string - `fullName` string - `gender` string - `geo` Geo - `country` Country2 - `code` string - `name` string - `coordinates` Coordinates - `latitude` number - `longitude` number - `verified` boolean - `language` Language - `name` string - `code` string - `officialArtist` boolean - `recentPostTypeStats` RecentPostTypeStat[] - `type` string - `value` number - `accountCategory` string - `top` Top - `mentions` CodeWeight[] - `code` string - `weight` number - `hashtags` CodeWeight[] - `code` string - `weight` number - `posts` Post[] - `likeCount` integer - `commentCount` integer - `playCount` integer - `viewCount` integer - `shareCount` integer - `saveCount` integer - `date` string, date-time - `imageUrl` string - `url` string - `text` string - `mentions` string[] - `hashTags` string[] - `sponsor` Sponsor - `username` string - `commercialPosts` Post[] - `likeCount` integer - `commentCount` integer - `playCount` integer - `viewCount` integer - `shareCount` integer - `saveCount` integer - `date` string, date-time - `imageUrl` string - `url` string - `text` string - `mentions` string[] - `hashTags` string[] - `sponsor` Sponsor - `username` string - `recentPosts` Post[] - `likeCount` integer - `commentCount` integer - `playCount` integer - `viewCount` integer - `shareCount` integer - `saveCount` integer - `date` string, date-time - `imageUrl` string - `url` string - `text` string - `mentions` string[] - `hashTags` string[] - `sponsor` Sponsor - `username` string - `reels` Reel[] - `date` string, date-time - `url` string - `text` string - `likeCount` integer - `commentCount` integer - `playCount` integer - `mentions` string[] - `recentReels` 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 - `totalLikes` integer - `averageSharePerPost` number - `averageSavePerPost` number - `averageDislike` number - `hiddenLikePosts` integer - `hiddenLikePostsRate` number - `paidPostPerformance` number - `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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `audienceAccountsCreatedAt` CodeWeight[] - `code` string - `weight` 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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `audienceAccountsCreatedAt` CodeWeight[] - `code` string - `weight` number - `audienceCommenter` 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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `averageLikes` number - `averageViews` number - `averageComments` number - `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 - `audienceAccountsCreatedAt` CodeWeight[] - `code` string - `weight` number - `brandsAffinity` string[] - `interests` string[] - `relevantTags` RelevantTag[] - `name` string - `distance` number - `freq` number - `similarUsers` User[] - `username` string - `fullName` string - `followerCount` integer - `engagementCount` integer - `averageLikes` number - `averageViews` number - `averageComments` number - `url` string - `imageUrl` string - `countryCode` string - `countryName` string - `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 ## Changes - **2026-09-03** `a2679c714df9`: 31 info - added the optional property `object/audience/audienceCommenter` to the response with the `200` status - added the optional property `object/audience/audienceFollower/audienceAccountsCreatedAt` to the response with the `200` status - added the optional property `object/audience/audienceFollower/lookalikes/items/averageComments` to the response with the `200` status - added the optional property `object/audience/audienceFollower/lookalikes/items/averageLikes` to the response with the `200` status - …27 more - **2026-07-26** `313fe03b999f`: 1 info - endpoint added [Operation history](https://skmtc.dev/soundcharts/apis/soundcharts-api/changes/api/v2/artist/:uuid/audience/:platform/report/post.md) --- [API](https://skmtc.dev/soundcharts/apis/soundcharts-api.md) - [All operations](https://skmtc.dev/soundcharts/apis/soundcharts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/soundcharts/apis/soundcharts-api/revisions/0ce4aea7eaf7?raw)