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
| Name | Description |
|---|---|
| ip_address | The IP address of the Plex Media server. |
| plex_token | The Plex token. |
| background | The 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 Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 401 | Unauthorized - The Plex token provided was not valid. |
| 404 | Not 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