Get a Movie's Background

Each movie on a Plex server is displayed with a background. This API command will get the full resolution background that is currently selected for the movie.

URL

GET http://{ip_address}:32400{background}?X-Plex-Token={plex_token}

Parameters

NameDescription
ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex token.
backgroundThe full path to the background. This path can be found by calling the Get a Movie API command and using the value from the art attribute from the Video element.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.
404Not Found - The background associated with the thumbnail path does not exist.

Response

The full resolution background is returned from the Plex server.

Examples

curl -X GET http://{ip_address}:32400{background}?X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400{background}?X-Plex-Token={plex_token}
response = requests.get(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://{ip_address}:32400{background}?X-Plex-Token={plex_token}' -Method 'GET'
Write-Output $response
Subscribe
Display