Playlist endpoints

[CulleyS 0]

I was reviewing both the Swagger docs and the GitHub docs for the Playlist endpoints in the Developer API, but am missing how to retrieve a list of all Playlists.

 

I was thinking I'd just need to do a GET request to /Playlists, but that returns a 404.

 

Here's an example of what I'm trying using httpie to hit the endpoint.

http "http://<my_ip>:8096/emby/Playlists?api_key=<my_api_key>"

And here is the response I'm seeing:

HTTP/1.1 404 Not Found
Content-Length: 34
Content-Type: text/html
Date: Thu, 13 Dec 2018 05:00:33 GMT
Server: Microsoft-NetCore/2.0

Unable to find the specified file.

[crunchyemby 9]

This may help:

 

http://{ip}:{port}/emby/Users/{user_id}/Items?api_key={api_key}&IncludeItemTypes=Playlist&format=json

 

...returns all playlists.

[Luke 40091]

Yes playlists can be queried just like any other kind of item. That's why there is no playlist-specific endpoint. Thanks.

[CulleyS 0]

Thanks for the replies. I've tried the above suggestion and variations on that. But the following requests all return the same same response (see below).

 

Requests:

http://{ip}:{port}/emby/Users/{id}/Items?IncludeItemTypes=Playlist&api_key={api_key}
http://{ip}:{port}/emby/Items?IncludeItemTypes=Playlist&api_key={api_key}
http://{ip}:{port}/emby/Users/{id}/Views?api_key={api_key}
http://{ip}:{port}/emby/Items?api_key={api_key}
http://{ip}:{port}/emby/Users/{id}/Items?IncludeItemTypes=Movie&api_key={api_key}
http://{ip}:{port}/emby/Users/{id}/Items?IncludeItemTypes=Episode&api_key={api_key}

Response:

{
  "Items": [
    {
      "Name": "Music videos",
      "ServerId": "obscured",
      "Id": "obscured",
      "IsFolder": true,
      "Type": "CollectionFolder",
      "UserData": {
        "PlaybackPositionTicks": 0,
        "PlayCount": 0,
        "IsFavorite": false,
        "Played": false,
        "Key": "obscured"
      },
      "CollectionType": "musicvideos",
      "ImageTags": {},
      "BackdropImageTags": [],
      "LocationType": "FileSystem"
    },
    {
      "Name": "Movies",
      "ServerId": "obscured",
      "Id": "obscured",
      "IsFolder": true,
      "Type": "CollectionFolder",
      "UserData": {
        "PlaybackPositionTicks": 0,
        "PlayCount": 0,
        "IsFavorite": false,
        "Played": false,
        "Key": "obscured"
      },
      "CollectionType": "movies",
      "ImageTags": {
        "Primary": "obscured"
      },
      "BackdropImageTags": [],
      "LocationType": "FileSystem"
    },
    {
      "Name": "TV Shows",
      "ServerId": "obscured",
      "Id": "obscured",
      "IsFolder": true,
      "Type": "CollectionFolder",
      "UserData": {
        "PlaybackPositionTicks": 0,
        "PlayCount": 0,
        "IsFavorite": false,
        "Played": false,
        "Key": "obscured"
      },
      "CollectionType": "tvshows",
      "ImageTags": {
        "Primary": "obscured"
      },
      "BackdropImageTags": [],
      "LocationType": "FileSystem"
    },
    {
      "Name": "Music",
      "ServerId": "obscured",
      "Id": "obscured",
      "IsFolder": true,
      "Type": "CollectionFolder",
      "UserData": {
        "PlaybackPositionTicks": 0,
        "PlayCount": 0,
        "IsFavorite": false,
        "Played": false,
        "Key": "obscured"
      },
      "CollectionType": "music",
      "ImageTags": {
        "Primary": "obscured"
      },
      "BackdropImageTags": [],
      "LocationType": "FileSystem"
    },
    {
      "Name": "Playlists",
      "ServerId": "obscured",
      "Id": "obscured",
      "IsFolder": true,
      "Type": "PlaylistsFolder",
      "UserData": {
        "PlaybackPositionTicks": 0,
        "PlayCount": 0,
        "IsFavorite": false,
        "Played": false,
        "Key": "obscured"
      },
      "CollectionType": "playlists",
      "ImageTags": {},
      "BackdropImageTags": [],
      "LocationType": "FileSystem"
    }
  ],
  "TotalRecordCount": 5
}

 

The following request returned the expected response.

http://{ip}:{port}/emby/Playlists/{id}/Items?api_key={api_key}

If it helps, the version of Emby Server I'm using is 3.5.3.0-1. Installed on Arch Linux.

 

Thank you.

[Luke 40091]

Add recursive=true

[CulleyS 0]

Perfect!

 

Thanks so much.