Skip to main content
GET
/
api
/
research
/
albums
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/research/albums
{
  "status": "success",
  "albums": [
    {
      "title": "<string>",
      "avatar": "<string>",
      "release_date": "<string>",
      "site_url": "<string>",
      "isrcs": [
        "<string>"
      ],
      "artists": [
        {
          "name": "<string>"
        }
      ]
    }
  ]
}

Query Parameters

​
artist_id
string
required

Provider artist ID. Obtain it from search or lookup results.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
Example:

"artist_123"

​
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 the provider's default 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

Artist catalog (albums view).

​
status
string
Example:

"success"

​
albums
object[]