Orchdio API documentation
  • ๐Ÿ‘‹Welcome!
  • Quick Start
  • Reference
    • API Reference
      • ๐Ÿ”’ Authentication
        • Spotify
        • Deezer
        • Apple Music
      • โš›๏ธEntity
        • Track
        • Playlist
      • ๐Ÿ“‘Library management
        • Add playlist to library
      • ๐Ÿ‘ฅAccount management
        • Account information
        • Library playlists
        • Library artists
        • Library albums
        • Listening history
      • ๐ŸชWebhooks
  • โš—๏ธMiscellaneous
    • Target platform values
    • ๐Ÿ”ฎShowcases
    • FAQ (The frequent "whats" and "whys")
Powered by GitBook
On this page
  1. Reference
  2. API Reference
  3. Account management

Library artists

PreviousLibrary playlistsNextLibrary albums

Last updated 2 years ago

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 . You'll get get new keys you can then update where the old keys were (securely) used.

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
}
๐Ÿ‘ฅ
dashboard
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: spotifyPossible values:
Header parameters
x-orchdio-keystring ยท uuidRequired

Your private key

Example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
Responses
200
Successful response
application/json
Responseany

User's library artists for specified platform

401
Unauthorized
application/json
500
Internal server error
application/json
get
GET /v1/account/{userId}/{platform}/artists HTTP/1.1
Host: api.orchdio.dev
x-orchdio-key: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
Accept: */*

No content