Library albums

Fetch a user's platform library albums

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 albums 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 albums 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 albums for specified platform

401

Unauthorized

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /v1/account/{userId}/{platform}/albums HTTP/1.1
Host: api.orchdio.dev
x-orchdio-key: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
Accept: */*

No content

The response looks like:

{
   "data":{
      "payload":[
         {
            "id":"7uwjGBdlLwCkJTMO6cyX18",
            "title":"First 48 Freestyle",
            "url":"https://open.spotify.com/album/7uwjGBdlLwCkJTMO6cyX18",
            "release_date":"2021-07-23",
            "explicit":false,
            "track_count":1,
            "artists":[
               "Boldy James",
               "The Alchemist"
            ],
            "cover":"https://i.scdn.co/image/ab67616d0000b27335df33272ff90a8c61ebbe05"
         }
      ]
   },
   "message":"User library artists returned",
   "status":200
}