Library artists

This endpoint requires that you use your private key. It is recommended to make the request from your own backend and make a request to that endpoint from the frontend of you app. This is to prevent accidentally leaking your private keys

If you notice your keys have been accidentally exposed, you can revoke them from the dashboard. You'll get get new keys you can then update where the old keys were (securely) used.

get

Returns the artists of the user on the specified platform

Path parameters

userIdanyrequired

The Orchdio ID of the user

Example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

platformstring · enumrequired

The platform to get the artists from

Example: spotifyAvailable options:

Header parameters

x-orchdio-keystring · uuidrequired

Your private key

Example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

Responses

application/json

application/json

application/json

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://api.orchdio.dev/v1/account/{userId}/{platform}/artists' \
  --header 'x-orchdio-key: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'

200

401

500

200

No Content

Successful response

The response looks like:

// Some code
{
   "data":{
      "payload":[
         {
            "id":"0ONHkAv9pCAFxb0zJwDNTy",
            "name":"Pusha T",
            "cover":"https://i.scdn.co/image/ab6761610000e5ebc5b88a3924d8318f25f20594",
            "url":"https://open.spotify.com/artist/0ONHkAv9pCAFxb0zJwDNTy"
         }
      ]
   },
   "message": "User library artists returned",
   "status": 200
}