Skip to main content
GET
cURL

Query Parameters

artist
string

Artist name; Recoup resolves the first provider search match. Required unless id is supplied. Recoup artist UUID resolution is not implemented here.

platform
string
default:instagram

Platform mapped to a provider audience metric source. Common values include instagram, tiktok, spotify, youtube_artist and youtube_channel. Unmapped strings pass through; provider support applies.

id
string

Research artist ID returned by search or lookup; treat it as an opaque string. Required unless artist is supplied; takes precedence when both are provided. This is not a Recoup artist/account ID.

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

"artist_123"

Response

Audience demographics

Provider audience payload. Available geographic and demographic fields vary by source and entitlement.

status
string
Example:

"success"

result
string
Example:

"success"

message
string
Example:

"Data Retrieved."

audience
object[]

Provider audience entries; fields vary by requested metric source. Empty data does not establish an absent audience.

artist_info
object

Provider-neutral artist reference.

source_ids
string[]