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 playlists

Fetch a user's platform library playlists

PreviousAccount informationNextLibrary artists

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 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":{
      "total":52,
      "payload":[
         {
            "id":"3uGVf9pmQe3b5VJXdgtUxu",
            "title":"House Mix",
            "description": "Deep house mixes",
            "duration_millis": 124678,
            "duration": "2:14",
            "public":true,
            "collaborative":false,
            "nb_tracks":50,
            "url":"https://open.spotify.com/playlist/3uGVf9pmQe3b5VJXdgtUxu",
            "cover":"https://mosaic.scdn.co/640/ab67616d0000b27345e61dc802ecd73217eb5cfcab67616d0000b273786201dca187d2b0c956c24bab67616d0000b273babf8c4ec73859b9ca95613fab67616d0000b273c3f072b383d10f76e61d3002",
            "created_at":"",
            "checksum":"MyxhYzg2MzhmMTNmYTM1NDE4NjkxMTg5OWViYmZiODYxOGZlOTM4ZWI3",
            "owner":"youngthebe",
            "fans": 2
         }
      ]
   },
   "message": "Spotify library playlists fetched",
   "status": 200
}

The following fields may be absent, as they are considered optional:

  • description

  • duration_millis

  • duration

  • created_at

  • fans

๐Ÿ‘ฅ
dashboard
get
Path parameters
userIdanyRequired

The Orchdio ID of the user

Example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
platformstring ยท enumRequired

The platform to get the playlists 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 playlists for specified platform

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

No content