Skip to main content
GET
/
api
/
research
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/research
{
  "status": "success",
  "results": [
    {
      "name": "<string>",
      "id": 123,
      "spotify_id": "<string>"
    }
  ]
}

Query Parameters

q
string
required

Artist name to search for.

type
enum<string>
default:artists

Entity type.

Available options:
artists,
tracks,
albums,
playlists,
curators,
stations
limit
integer
default:10

Maximum number of results.

Response

200 - application/json

Search results

status
enum<string>
Available options:
success,
error
results
object[]

Matching artists with IDs, names, and basic metadata.