Get Artist Fans

Retrieve all social profiles from fans of an artist across all platforms. This endpoint aggregates fan data from all connected social media platforms. Supports pagination for large fan lists.

GET /api/artists/{id}/fans

cURL

cURL

curl --request GET \
  --url https://api.recoupable.com/api/artists/{id}/fans

import requests

url = "https://api.recoupable.com/api/artists/{id}/fans"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.recoupable.com/api/artists/{id}/fans', 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.com/api/artists/{id}/fans",
  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.com/api/artists/{id}/fans"

	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.com/api/artists/{id}/fans")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recoupable.com/api/artists/{id}/fans")

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

200

{
  "status": "success",
  "fans": [
    {
      "id": "<string>",
      "username": "<string>",
      "avatar": "<string>",
      "profile_url": "<string>",
      "region": "<string>",
      "bio": "<string>",
      "follower_count": 123,
      "following_count": 123,
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "total_count": 123,
    "page": 123,
    "limit": 123,
    "total_pages": 123
  }
}

{
  "status": "error",
  "error": "<string>"
}

{
  "status": "error",
  "error": "<string>"
}

{
  "status": "error",
  "error": "<string>"
}

Path Parameters

id · string<uuid> · required

The unique identifier of the artist account to fetch fans for

Query Parameters

page · integer · default: 1

The page number to retrieve (default: 1)

limit · integer · default: 20

The number of records per page (default: 20, max: 100)

Required range: x <= 100

Response

200

application/json

Artist fans retrieved successfully

status · enum<string> · required

Status of the request

Available options: success

fans · object[] · required

List of social profiles from fans across all platforms

Show child attributes

pagination · object · required

Pagination metadata for the response

Show child attributes