curl --request GET \
--url https://api.recoupable.dev/api/artists/{id}/profileimport requests
url = "https://api.recoupable.dev/api/artists/{id}/profile"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/artists/{id}/profile', 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/artists/{id}/profile",
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/artists/{id}/profile"
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/artists/{id}/profile")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}/profile")
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{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"image": "<string>",
"socials": [
{
"type": "SPOTIFY",
"username": "<string>",
"profile_url": "<string>"
}
],
"catalogs": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"song_count": 123,
"updated_at": "2023-11-07T05:31:56Z",
"songs": [
{
"isrc": "QZTPX2553097",
"name": "<string>",
"album": "<string>",
"artwork_url": "<string>",
"plays": 123,
"est_value_usd": 123
}
]
}
],
"valuation": {
"low": 123,
"mid": 123,
"high": 123
}
}{
"status": "error",
"error": "Artist not found"
}Get Artist Profile
Public artist profile: the artist’s name, image, connected social profiles, and linked catalogs in one call.
No authentication. This endpoint is deliberately public and unbilled — it backs the shareable artist page at chat.recoupable.dev/artists/{id} and can be called without an API key. Only public fields are returned; account settings, instructions, and valuation data are never included.
Responses are cacheable (Cache-Control: public, s-maxage=300, stale-while-revalidate=600), so a value may be up to a few minutes stale.
curl --request GET \
--url https://api.recoupable.dev/api/artists/{id}/profileimport requests
url = "https://api.recoupable.dev/api/artists/{id}/profile"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/artists/{id}/profile', 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/artists/{id}/profile",
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/artists/{id}/profile"
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/artists/{id}/profile")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}/profile")
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{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"image": "<string>",
"socials": [
{
"type": "SPOTIFY",
"username": "<string>",
"profile_url": "<string>"
}
],
"catalogs": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"song_count": 123,
"updated_at": "2023-11-07T05:31:56Z",
"songs": [
{
"isrc": "QZTPX2553097",
"name": "<string>",
"album": "<string>",
"artwork_url": "<string>",
"plays": 123,
"est_value_usd": 123
}
]
}
],
"valuation": {
"low": 123,
"mid": 123,
"high": 123
}
}{
"status": "error",
"error": "Artist not found"
}Path Parameters
The unique identifier (UUID) of the artist account.
Response
Artist profile retrieved successfully.
The artist's account id.
The artist's display name.
URL of the artist's profile image, or null when none is set.
Connected social profiles, empty when none are linked.
Show child attributes
Show child attributes
Catalogs linked to the artist, newest first; empty when none are linked.
Show child attributes
Show child attributes
Estimated value band for the artist's catalog(s), from the published Recoup valuation model over all credited songs' latest play counts. Null when the artist has no measured songs.
Show child attributes
Show child attributes
Was this page helpful?
