Skip to main content
GET
/
api
/
research
/
audience
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/research/audience
{
  "status": "success",
  "result": "success",
  "message": "Data Retrieved.",
  "audience": [
    {}
  ],
  "artist_info": {
    "id": "wjcgfd9i",
    "name": "Drake",
    "avatar": "<string>",
    "site_url": "<string>"
  },
  "source_ids": [
    "<string>"
  ]
}

Query Parameters

​
artist
string

Artist name. Required unless id is provided.

​
platform
enum<string>
default:instagram

Platform to get demographics for. Defaults to instagram.

Available options:
instagram,
tiktok,
youtube
​
id
string

Provider artist ID returned by lookup or search. Required unless artist is provided.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
Example:

"artist_123"

Response

Audience demographics

Audience demographics for the requested platform.

​
status
string
Example:

"success"

​
result
string
Example:

"success"

​
message
string
Example:

"Data Retrieved."

​
audience
object[]

Per-platform audience demographic entries. May be empty when the provider has no data for the artist/platform.

​
artist_info
object

Provider-neutral artist reference.

​
source_ids
string[]