Skip to main content
GET
/
library
/
metadata
/
{ids}
PlexGO
package main

import(
	"context"
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"github.com/LukeHagar/plexgo/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := plexgo.New(
        plexgo.WithAccepts(components.AcceptsApplicationXML),
        plexgo.WithClientIdentifier("abc123"),
        plexgo.WithProduct("Plex for Roku"),
        plexgo.WithVersion("2.4.1"),
        plexgo.WithPlatform("Roku"),
        plexgo.WithPlatformVersion("4.3 build 1057"),
        plexgo.WithDevice("Roku 3"),
        plexgo.WithModel("4200X"),
        plexgo.WithDeviceVendor("Roku"),
        plexgo.WithDeviceName("Living Room TV"),
        plexgo.WithMarketplace("googlePlay"),
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Content.GetMetadataItem(ctx, operations.GetMetadataItemRequest{
        Ids: []string{},
        AsyncCheckFiles: components.BoolIntOne.ToPointer(),
        AsyncRefreshLocalMediaAgent: components.BoolIntOne.ToPointer(),
        AsyncRefreshAnalysis: components.BoolIntOne.ToPointer(),
        CheckFiles: components.BoolIntOne.ToPointer(),
        SkipRefresh: components.BoolIntOne.ToPointer(),
        CheckFileAvailability: components.BoolIntOne.ToPointer(),
        AsyncAugmentMetadata: components.BoolIntOne.ToPointer(),
        AugmentCount: components.BoolIntOne.ToPointer(),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.MediaContainerWithMetadata != nil {
        // handle response
    }
}
{
  "MediaContainer": {
    "identifier": "<string>",
    "offset": 123,
    "size": 123,
    "totalSize": 123,
    "Metadata": [
      {
        "title": "<any>",
        "type": "<any>",
        "absoluteIndex": 123,
        "addedAt": 123,
        "art": "<any>",
        "audienceRating": 5,
        "audienceRatingImage": "<any>",
        "Autotag": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "banner": "<any>",
        "chapterSource": "<any>",
        "composite": "<any>",
        "contentRating": "<any>",
        "Country": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "Director": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "duration": 123,
        "Filter": [
          {
            "title": "<string>",
            "type": "<string>",
            "art": "<string>",
            "content": true,
            "filter": "<string>",
            "hasPrefs": true,
            "hasStoreServices": true,
            "hubKey": "<string>",
            "identifier": "<string>",
            "key": "<string>",
            "lastAccessedAt": 123,
            "Pivot": [
              {}
            ],
            "share": 123,
            "thumb": "<string>",
            "titleBar": "<string>",
            "filterType": "<string>"
          }
        ],
        "Genre": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "grandparentArt": "<string>",
        "grandparentHero": "<string>",
        "grandparentKey": "<string>",
        "grandparentRatingKey": "<string>",
        "grandparentTheme": "<string>",
        "grandparentThumb": "<string>",
        "grandparentTitle": "<string>",
        "Guid": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "hero": "<any>",
        "Image": [
          {
            "type": "background",
            "alt": "<string>",
            "url": "<string>"
          }
        ],
        "index": 123,
        "key": "<any>",
        "lastViewedAt": 123,
        "leafCount": 123,
        "Media": [
          {
            "aspectRatio": 2.35,
            "audioChannels": 2,
            "audioCodec": "<any>",
            "audioProfile": "<any>",
            "bitrate": 5612,
            "container": "<any>",
            "duration": 150192,
            "has64bitOffsets": false,
            "hasVoiceActivity": true,
            "height": 544,
            "id": 1,
            "optimizedForStreaming": false,
            "Part": [
              {
                "audioProfile": "<any>",
                "container": "<any>",
                "duration": 150192,
                "file": "<any>",
                "has64bitOffsets": false,
                "id": 1,
                "key": "<any>",
                "optimizedForStreaming": false,
                "size": 105355654,
                "Stream": [
                  {
                    "default": true,
                    "audioChannelLayout": "<any>",
                    "bitDepth": 8,
                    "bitrate": 5466,
                    "canAutoSync": true,
                    "chromaLocation": "<any>",
                    "chromaSubsampling": "<any>",
                    "codec": "<any>",
                    "colorPrimaries": "<any>",
                    "colorRange": "<any>",
                    "colorSpace": "<any>",
                    "colorTrc": "<any>",
                    "displayTitle": "<any>",
                    "frameRate": 23.976,
                    "hasScalingMatrix": "<any>",
                    "height": 544,
                    "id": 1,
                    "index": 0,
                    "key": "<any>",
                    "language": "<any>",
                    "languageCode": "<any>",
                    "level": 31,
                    "profile": "<any>",
                    "refFrames": 2,
                    "samplingRate": 48000,
                    "selected": true,
                    "streamIdentifier": 1,
                    "streamType": 1,
                    "width": 1280
                  }
                ],
                "videoProfile": "<any>"
              }
            ],
            "videoCodec": "<any>",
            "videoFrameRate": "<any>",
            "videoProfile": "<any>",
            "videoResolution": "<any>",
            "width": 1280
          }
        ],
        "originallyAvailableAt": "<any>",
        "originalTitle": "<any>",
        "parentHero": "<string>",
        "parentIndex": 123,
        "parentKey": "<string>",
        "parentRatingKey": "<string>",
        "parentThumb": "<string>",
        "parentTitle": "<string>",
        "primaryExtraKey": "<any>",
        "prompt": "<string>",
        "rating": 5,
        "Rating": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "ratingCount": 123,
        "ratingImage": "<any>",
        "ratingKey": "<any>",
        "Role": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "search": true,
        "secondary": true,
        "skipChildren": true,
        "skipParent": true,
        "Sort": [
          {
            "title": "<string>",
            "type": "<string>",
            "art": "<string>",
            "content": true,
            "filter": "<string>",
            "hasPrefs": true,
            "hasStoreServices": true,
            "hubKey": "<string>",
            "identifier": "<string>",
            "key": "<string>",
            "lastAccessedAt": 123,
            "Pivot": [
              {}
            ],
            "share": 123,
            "thumb": "<string>",
            "titleBar": "<string>",
            "default": "asc",
            "defaultDirection": "asc",
            "descKey": "<string>",
            "firstCharacterKey": "<string>"
          }
        ],
        "studio": "<any>",
        "subtype": "<any>",
        "summary": "<any>",
        "tagline": "<any>",
        "theme": "<any>",
        "thumb": "<any>",
        "titleSort": "<any>",
        "updatedAt": 123,
        "userRating": 5,
        "viewCount": 123,
        "viewedLeafCount": 123,
        "viewOffset": 123,
        "Writer": [
          {
            "confidence": 123,
            "context": "<string>",
            "filter": "<any>",
            "id": 123,
            "ratingKey": "<string>",
            "role": "<any>",
            "tag": "<any>",
            "tagKey": "<any>",
            "tagType": 123,
            "thumb": "<any>"
          }
        ],
        "year": 123
      }
    ]
  }
}

Authorizations

​
X-Plex-Token
string
header
required

Headers

​
accepts
enum<string>
default:application/xml
Available options:
application/json,
application/xml
​
X-Plex-Client-Identifier
string
required
Example:
​
X-Plex-Product
string
Example:
​
X-Plex-Version
string
Example:
​
X-Plex-Platform
string
Example:
​
X-Plex-Platform-Version
string
Example:
​
X-Plex-Device
string
Example:
​
X-Plex-Model
string
Example:
​
X-Plex-Device-Vendor
string
Example:
​
X-Plex-Device-Name
string
Example:
​
X-Plex-Marketplace
string
Example:

Path Parameters

​
ids
string[]
required

Query Parameters

​
asyncCheckFiles
enum<integer>
Available options:
0,
1
​
asyncRefreshLocalMediaAgent
enum<integer>
Available options:
0,
1
​
asyncRefreshAnalysis
enum<integer>
Available options:
0,
1
​
checkFiles
enum<integer>
Available options:
0,
1
​
skipRefresh
enum<integer>
Available options:
0,
1
​
checkFileAvailability
enum<integer>
Available options:
0,
1
​
asyncAugmentMetadata
enum<integer>
Available options:
0,
1
​
augmentCount
enum<integer>
Available options:
0,
1

Response

200 - application/json
​
MediaContainer
object