Plex API - get show metadata with folder location and possibly extras

umamaheshwarreddy
Wed, 15 Apr 2026 04:46:07 +0000
Dev/API Corner

I am trying to get the library items metadata from plex API (referencing https://developer.plex.tv/pms/).

Here’s what I have done so far:

Got the Auth Token Request figured out - successfully able to use OAuth to get the Token

Got the library sections from api using {self.server_url}/library/sections

Now I am trying to get the media metadata with folder path, GUIDs, Extras (if possible). I tried using {self.server_url}/library/sections/{section_key}/all?includeGuids=1&includeDetails=1 and also {self.server_url}/library/sections/{section_key}/all?includeGuids=1&includeDetails=1

Also tried adding extra query parameters like includeExtras=1, includeFields=OnDeck,Extras, includeOptionalFields=OnDeck,Extras. No luck.

Now here’s my problem:

When I use the /library/sections/{sectionKey}/all it works for movies to get GUIDs, media file path, but not extras in the same request. Also, didn’t find an API call to get extras info for all items in a single call (or paginated). Requesting extras for 1 movie at a time didn’t seem like a good solution. And for shows section this doesn’t include any media file/folder paths - which is a requirement for my use case.

When I use the /library/sections/{sectionKey}/allLeaves it works for both movies and shows, but not extras, or GUIDs for shows as this is episode data for shows section. So, to get the GUIDs I need to make another call to the /library/sections/{sectionKey}/all endpoint - which doesn’t seem like a good solution either.

The API documentation does have a section for “Response Customization”, wasn’t able to figure how to customize the responses with the GUIDs. file/folder path, and Extras.

Has anyone figured it out? Can someone please help?

5 posts - 2 participants