curl --request GET \
--url https://api.recoupable.dev/api/artists/{id}/socialsimport requests
url = "https://api.recoupable.dev/api/artists/{id}/socials"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/artists/{id}/socials', 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}/socials",
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}/socials"
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}/socials")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}/socials")
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",
"socials": [
{
"social_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"username": "<string>",
"profile_url": "<string>",
"avatar": "<string>",
"bio": "<string>",
"follower_count": 123,
"following_count": 123,
"region": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"history": [
{
"captured_at": "2023-11-07T05:31:56Z",
"follower_count": 123,
"following_count": 123,
"post_count": 123
}
]
}
],
"pagination": {
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Get Artist Socials
Retrieve all social media profiles associated with an artist, with the latest follower counts from the most recent scrape. Call this before the Social Posts or Social Scrape endpoints to obtain the social IDs. Pass history to also get each profile’s follower snapshots, so week-over-week movement is a read instead of something the caller has to remember.
curl --request GET \
--url https://api.recoupable.dev/api/artists/{id}/socialsimport requests
url = "https://api.recoupable.dev/api/artists/{id}/socials"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.recoupable.dev/api/artists/{id}/socials', 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}/socials",
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}/socials"
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}/socials")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}/socials")
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",
"socials": [
{
"social_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"username": "<string>",
"profile_url": "<string>",
"avatar": "<string>",
"bio": "<string>",
"follower_count": 123,
"following_count": 123,
"region": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"history": [
{
"captured_at": "2023-11-07T05:31:56Z",
"follower_count": 123,
"following_count": 123,
"post_count": 123
}
]
}
],
"pagination": {
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}{
"status": "error",
"message": "<string>"
}Path Parameters
The unique identifier of the artist account to fetch social profiles for
Query Parameters
The page number to retrieve (default: 1)
The number of records per page (default: 20, max: 100)
x <= 100Number of days of follower snapshots to include per profile as history, newest first. Snapshots are written by every scrape that reports a follower count, one point per social per day (the latest scrape that day wins), so a profile has one point after its first scrape and a second only after a scrape on a later day. Omitted: no history field on the profiles.
1 <= x <= 90Response
Social profiles retrieved successfully
Was this page helpful?
