Skip to main content
GET
/
api
/
research
/
audience
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/audience
{
  "status": "success",
  "timestp": "<string>",
  "followers": 123,
  "avg_likes_per_post": 123,
  "avg_commments_per_post": 123,
  "engagement_rate": 123,
  "top_countries": [
    {}
  ],
  "top_cities": [
    {}
  ],
  "likers_top_countries": [
    {}
  ],
  "likers_top_cities": [
    {}
  ],
  "audience_genders": [
    {}
  ],
  "audience_genders_per_age": [
    {}
  ],
  "audience_ethnicities": [
    {}
  ],
  "audience_interests": [
    {}
  ],
  "audience_brand_affinities": [
    {}
  ],
  "audience_likers_genders": [
    {}
  ],
  "audience_likers_genders_per_age": [
    {}
  ],
  "audience_likers_ethnicities": [
    {}
  ],
  "audience_likers_interests": [
    {}
  ],
  "audience_likers_brand_affinities": [
    {}
  ],
  "notable_followers": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
artist
string
required

Artist name or Recoup artist ID (UUID).

​
platform
enum<string>
default:instagram

Platform to get demographics for. Defaults to instagram.

Available options:
instagram,
tiktok,
youtube

Response

Audience demographics

Audience demographics and engagement metrics from Chartmetric. Contains two parallel families of fields: followers (audience_* and top_*) describe the artist's follower base, while likers (audience_likers_*, likers_top_*) describe the people who engage (like/comment) with the artist's posts. Engagement aggregates (followers, avg_likes_per_post, engagement_rate) and notable_followers round out the payload. All array shapes are upstream Chartmetric objects that pass through via additionalProperties.

​
status
string
Example:

"success"

​
timestp
string

ISO timestamp at which this audience snapshot was captured.

​
followers
integer

Follower count on the underlying platform at snapshot time.

​
avg_likes_per_post
integer
​
avg_commments_per_post
integer

Note: field name is misspelled upstream as avg_commments_per_post.

​
engagement_rate
number
​
top_countries
object[]

Top countries by audience share.

​
top_cities
object[]

Top cities by audience concentration.

​
likers_top_countries
object[]

Top countries for the likers (engagement) cohort.

​
likers_top_cities
object[]

Top cities for the likers cohort.

​
audience_genders
object[]

Gender breakdown of the follower base.

​
audience_genders_per_age
object[]

Follower gender split per age bracket.

​
audience_ethnicities
object[]
​
audience_interests
object[]
​
audience_brand_affinities
object[]

Brand affinity scores for the follower cohort.

​
audience_likers_genders
object[]
​
audience_likers_genders_per_age
object[]
​
audience_likers_ethnicities
object[]
​
audience_likers_interests
object[]
​
audience_likers_brand_affinities
object[]

Brand affinity scores for the likers cohort.

​
notable_followers
object[]

Notable public/influential accounts in the follower base.