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/fans

cURL

cURL

curl --request GET \
  --url https://api.recoupable.com/api/fans \
  --header 'x-api-key: <api-key>'

200

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

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Query Parameters

artist_account_id · string<uuid> · required

The unique identifier of the artist account to fetch fans for

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