Skip to main content
GET
/
api
/
research
/
albums
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/albums
{
  "status": "success",
  "albums": [
    {
      "name": "<string>",
      "id": 123,
      "release_date": "<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_id
string
required

Chartmetric artist ID (positive integer). Obtain via GET /api/research with type=artists&beta=true — the id field in each result is the Chartmetric ID to pass here.

Pattern: ^[1-9][0-9]*$
Example:

"3380"

​
is_primary
enum<string>
default:true

When true (default), returns only albums where the artist is a main artist. Set to false to include feature appearances, DJ compilations, and soundtracks.

Available options:
true,
false
​
limit
string

Number of albums to return. Defaults to Chartmetric's default (100) when omitted.

Pattern: ^[1-9][0-9]*$
​
offset
string

Pagination offset. Defaults to 0 when omitted.

Pattern: ^(0|[1-9][0-9]*)$

Response

Artist albums

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

"success"

​
albums
object[]