Skip to main content
GET
/
api
/
research
/
profile
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/profile
{
  "status": "<string>",
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "cover_url": "<string>",
  "code2": "<string>",
  "isni": "<string>",
  "band": true,
  "band_members": "<unknown>",
  "gender": "<string>",
  "gender_title": "<string>",
  "pronoun_title": "<string>",
  "hometown_city": "<unknown>",
  "current_city": "<string>",
  "current_city_id": 123,
  "cm_artist_rank": 123,
  "cm_artist_score": 123,
  "cm_statistics": {},
  "career_status": {},
  "genres": {},
  "genre_smart_ordered": [
    {}
  ],
  "genreRank": {},
  "subGenreRank1": {},
  "subGenreRank2": {},
  "moods": [
    {}
  ],
  "activities": [
    {}
  ],
  "record_label": "<string>",
  "booking_agent": "<string>",
  "press_contact": "<string>",
  "general_manager": "<string>",
  "topSongwriterCollaborators": [
    {}
  ],
  "created_at": "<string>"
}

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

​
artist
string
required

Artist name or Recoup artist ID (UUID).

Response

Artist profile

Full artist profile — identity, biography, genres, geography, label/management, and Chartmetric-derived ranks/statistics. For longitudinal platform metrics (Spotify followers/listeners over time, social stats, etc.) call GET /api/research/metrics instead.

​
status
string
​
id
integer

Chartmetric artist ID.

​
name
string
​
description
string | null
​
image_url
string | null
​
cover_url
string | null
​
code2
string | null

ISO country code associated with the artist.

​
isni
string | null
​
band
boolean

True if the artist is a band/group rather than a solo act.

​
band_members
any | null

Band-member objects when known.

​
gender
string | null
​
gender_title
string | null
​
pronoun_title
string | null
​
hometown_city
any | null

Chartmetric hometown-city object (null when unknown).

​
current_city
string | null
​
current_city_id
integer | null
​
cm_artist_rank
integer

Overall Chartmetric artist rank (lower is better).

​
cm_artist_score
number

Chartmetric artist-score aggregate (higher is better).

​
cm_statistics
object

Aggregated cross-platform snapshot — Spotify followers/monthly_listeners, Instagram/TikTok/YouTube counts, chart positions, etc. Fields may be null per-platform.

​
career_status
object

Current career stage + momentum (e.g. superstar/mainstream/developing + growth/steady/decline).

​
genres
object

Primary/secondary/sub-genre breakdown. Object with keyed subgroups, not a flat array.

​
genre_smart_ordered
object[]
​
genreRank
object
​
subGenreRank1
object
​
subGenreRank2
object
​
moods
object[]
​
activities
object[]
​
record_label
string | null
​
booking_agent
string | null
​
press_contact
string | null
​
general_manager
string | null
​
topSongwriterCollaborators
object[]
​
created_at
string