Skip to main content
GET
/
media
/
{mediaId}
/
images
Get media images
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.discovr.media/media/{mediaId}/images', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": 550,
  "backdrops": [
    {
      "aspect_ratio": 1.778,
      "file_path": "/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "url": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "height": 1080,
      "width": 1920,
      "iso_639_1": "en",
      "vote_average": 5.384,
      "vote_count": 13
    }
  ],
  "logos": [
    {
      "aspect_ratio": 1.778,
      "file_path": "/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "url": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "height": 1080,
      "width": 1920,
      "iso_639_1": "en",
      "vote_average": 5.384,
      "vote_count": 13
    }
  ],
  "posters": [
    {
      "aspect_ratio": 1.778,
      "file_path": "/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "url": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "height": 1080,
      "width": 1920,
      "iso_639_1": "en",
      "vote_average": 5.384,
      "vote_count": 13
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/pages/*, /profile/*) accept a short-lived session JWT.

SDK clients use two typed API accessors (identityApi() with the refresh token vs sessionApi() with the session JWT) — see the SDK DiscovrAuth helper.

Format: Authorization: Bearer {token}

Path Parameters

​
mediaId
string
required

The unique identifier of the media item (e.g., "MV_550", "TV_1399")

Pattern: ^(MV|TV)_\d+$

Query Parameters

​
language
string

ISO 639-1 language code to filter images by language. If specified, acts as a filter on returned items.

Example:

"en"

​
include_image_language
string

Comma-separated ISO 639-1 language codes to include additional languages. Can be used with or without the language parameter.

Example:

"en,es,fr"

Response

Media images retrieved successfully

Images response from TMDB matching their exact structure

​
id
integer

TMDB ID (may be present in some responses)

Example:

550

​
backdrops
object[]

Array of backdrop images

​
logos
object[]

Array of logo images

​
posters
object[]

Array of poster images