curl --request GET \
--url https://api.recoupable.dev/api/research/metricsimport requests
url = "https://api.recoupable.dev/api/research/metrics"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/research/metrics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recoupable.dev/api/research/metrics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.recoupable.dev/api/research/metrics"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.recoupable.dev/api/research/metrics")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/research/metrics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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>"
]
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"error": "insufficient_credits",
"remaining_credits": 0,
"required_credits": 50000,
"billingUrl": "https://app.recoupable.dev"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Request failed with status 501"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}Platform Metrics
Read current artist statistics for the required platform source. This is a synchronous snapshot, without a historical series or refresh-pending job. A valid source does not guarantee data is available. Save dated responses to compare results over time.
Use your Recoup API key (x-api-key) or supported bearer credential. Successful artist and track research reads cost $0.05 (50,000 micro-dollar credits). Recoup manages the data connections. Coverage and rate limits vary; see Research availability.
curl --request GET \
--url https://api.recoupable.dev/api/research/metricsimport requests
url = "https://api.recoupable.dev/api/research/metrics"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/research/metrics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recoupable.dev/api/research/metrics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.recoupable.dev/api/research/metrics"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.recoupable.dev/api/research/metrics")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/research/metrics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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>"
]
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"error": "insufficient_credits",
"remaining_credits": 0,
"required_credits": 50000,
"billingUrl": "https://app.recoupable.dev"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Request failed with status 501"
}{
"status": "error",
"error": "Missing required parameter: artist"
}{
"status": "error",
"error": "Missing required parameter: artist"
}Query Parameters
Artist name; Recoup resolves the first provider search match. Required unless id is supplied. Recoup artist UUID resolution is not implemented here.
Platform to get metrics for.
spotify, instagram, tiktok, twitter, facebook, youtube_channel, youtube_artist, soundcloud, deezer, twitch, line, melon, wikipedia, bandsintown, radio, sxm 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.
^[A-Za-z0-9][A-Za-z0-9._:-]*$"artist_123"
Response
Platform metrics over time
Current statistics for the artist on the requested source.
Was this page helpful?
