cURL

curl --request GET \
  --url https://api.recoupable.com/api/research

{
  "status": "success",
  "results": [
    {
      "id": "<string>",
      "name": "<string>",
      "avatar": "<string>",
      "site_url": "<string>"
    }
  ]
}

Artist discovery

Search

Unified music research search. This is the discovery primitive for the detail-lookup endpoints — use type=artists to find an id for GET /api/research/albums, type=tracks for GET /api/research/track, type=playlists for GET /api/research/playlist, etc. Pick the right id from the returned results and pass it to the appropriate detail endpoint.

Searches the configured research data source. Use the type and limit parameters to narrow results before passing a returned id to a detail endpoint.

GET

api

research

cURL

curl --request GET \
  --url https://api.recoupable.com/api/research

{
  "status": "success",
  "results": [
    {
      "id": "<string>",
      "name": "<string>",
      "avatar": "<string>",
      "site_url": "<string>"
    }
  ]
}

Query Parameters

string

required

Search query. Can be a name (e.g. Drake, Flowers) or a streaming-platform URL (e.g. https://open.spotify.com/artist/...).

type

enum<string>

default:artists

Entity type to search: artists, tracks, or labels.

Available options:

artists,

tracks,

labels

limit

integer

default:10

Maximum number of results.

offset

string

Pagination offset. Defaults to 0 when omitted.

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

Response

Search results

status

enum<string>

Available options:

success,

error

Example:

"success"

results

object[]

Matching artists with IDs, names, and basic metadata.

Show child attributes

Lookup by URL