Skip to main content
GET
/
api
/
research
/
metrics
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/research/metrics
{
  "status": "<string>",
  "data": [
    {}
  ]
}

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

200 - application/json

Platform metrics over time

Time-series metrics for a specific platform. Shape varies by source — typically an array of data points with timestamps and values (followers, listeners, views, etc.).

​
status
string
​
data
object[]

Array of time-series data points. Fields vary by platform.