Skip to main content
GET
/
media
/
{mediaId}
/
images
TypeScript
import { DiscovrClient } from "discovr";
import type { MediaImagesResponse } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: MediaImagesResponse = await discovr.getMediaImages("example", { language: "en", include_image_language: "en,null" });
console.log(response);
{
  "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. Use MV_<id> for movies or TV_<id> for TV shows (e.g., MV_550, TV_1396).

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

Query Parameters

​
language
string

ISO 639-1 language code to filter images (e.g., en).

Example:

"en"

​
include_image_language
string

Comma-separated ISO 639-1 language codes to include in results. Use null to include language-neutral images (e.g., en,null).

Example:

"en,null"

Response

Image assets returned successfully.

All available image assets for a title, organized by type.

​
id
integer

Numeric identifier for the title.

Example:

550

​
backdrops
object[]

Backdrop images (widescreen scene stills).

​
logos
object[]

Logo images (title treatments and brand marks).

​
posters
object[]

Poster images (portrait-orientation key art).