Skip to main content
GET
/
api
/
research
/
metrics
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/research/metrics
{
  "status": "success",
  "result": "success",
  "message": "Data Retrieved.",
  "stats": [
    {
      "source": "<string>",
      "data": {
        "monthly_listeners_current": 99222567,
        "followers_total": 112035525,
        "popularity_current": 100,
        "streams_total": 137582496099,
        "playlists_current": 169220,
        "charts_current": 184
      }
    }
  ],
  "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.

​
source
enum<string>
required

Platform to get metrics for.

Available options:
spotify,
instagram,
tiktok,
twitter,
facebook,
youtube_channel,
youtube_artist,
soundcloud,
deezer,
twitch,
line,
melon,
wikipedia,
bandsintown,
radio,
sxm
​
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

Platform metrics over time

Current statistics for the artist on the requested source.

​
status
string
Example:

"success"

​
result
string
Example:

"success"

​
message
string
Example:

"Data Retrieved."

​
stats
object[]
​
artist_info
object

Provider-neutral artist reference.

​
source_ids
string[]

Sources included in stats.