Skip to main content
GET
/
api
/
research
/
metrics
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/metrics
{
  "status": "<string>",
  "link": "<string>",
  "followers": [
    {
      "timestp": "<string>",
      "value": 123
    }
  ],
  "listeners": [
    {
      "timestp": "<string>",
      "value": 123
    }
  ],
  "popularity": [
    {
      "timestp": "<string>",
      "value": 123
    }
  ],
  "followers_to_listeners_ratio": [
    {
      "timestp": "<string>",
      "value": 123
    }
  ]
}

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).

​
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

Response

Platform metrics over time

Time-series metrics for the artist on the selected platform. Shape varies by platform — fields at the root (not wrapped in a data envelope) each hold their own time-series array of {timestp, value} points.

For Spotify, expect followers, listeners, popularity, and followers_to_listeners_ratio. Other platforms expose their own set (e.g. subscribers and views for youtube_channel).

​
status
string
​
link
string

Canonical source URL on the upstream platform (e.g. the artist's Spotify URL).

​
followers
object[]

Time series of follower counts, when applicable to the source.

​
listeners
object[]

Time series of listener counts (e.g. Spotify monthly listeners), when applicable.

​
popularity
object[]

Time series of the platform's popularity score, when applicable.

​
followers_to_listeners_ratio
object[]

Derived time series, when both followers and listeners are available (Spotify).