Skip to main content
GET
/
api
/
research
/
curator
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/curator
{
  "status": "success",
  "id": 123,
  "user_id": "<string>",
  "name": "<string>",
  "image_url": "<string>",
  "submithub_id": "<string>",
  "last_updated": "<string>",
  "suspicion_score": 123,
  "tags": [
    {}
  ],
  "tag_ids": [
    123
  ],
  "tag_names": [
    "<string>"
  ],
  "spotifySocialUrls": [
    {}
  ],
  "cm_statistics": {},
  "instagram_followers": 123,
  "facebook_followers": 123,
  "facebook_fans": 123,
  "twitter_followers": 123,
  "twitter_retweets": 123,
  "youtube_subscribers": 123,
  "youtube_views": 123,
  "soundcloud_followers": 123,
  "tiktok_followers": 123,
  "tiktok_likes": 123
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

platform
enum<string>
required

Streaming platform. Only Spotify, Apple Music, and Deezer have curator metadata on Chartmetric. (YouTube and Amazon are not supported by this endpoint.)

Available options:
spotify,
applemusic,
deezer
id
string
required

Numeric Chartmetric curator ID (e.g. 2 for Spotify's own account). Non-numeric values will be rejected. Obtain via GET /api/research with type=curators&beta=true.

Pattern: ^[0-9]+$
Example:

"2"

Response

Curator profile

Curator profile. Follower counts are split by platform (instagram_followers, facebook_followers, twitter_followers, youtube_subscribers, soundcloud_followers, tiktok_followers), each nullable when unknown. Aggregated signals live under cm_statistics.

status
enum<string>
Available options:
success,
error
Example:

"success"

id
integer

Chartmetric curator ID.

user_id
string

Platform-native curator/user ID (e.g. Spotify user ID).

name
string
image_url
string<uri> | null
submithub_id
string | null
last_updated
string

ISO timestamp of the last Chartmetric sync.

suspicion_score
integer

Chartmetric's internal suspicion score (lower is better).

tags
object[]
tag_ids
integer[]
tag_names
string[]
spotifySocialUrls
object[]

Spotify-linked social URLs for the curator.

cm_statistics
object

Aggregated Chartmetric statistics — playlist reach, editorial counts, velocity deltas, etc.

instagram_followers
integer | null
facebook_followers
integer | null
facebook_fans
integer | null
twitter_followers
integer | null
twitter_retweets
integer | null
youtube_subscribers
integer | null
youtube_views
integer | null
soundcloud_followers
integer | null
tiktok_followers
integer | null
tiktok_likes
integer | null