Skip to main content

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.

Retrieves images (backdrops, logos, and posters) for a specific media item (Movie or TV Show) by its ID. The ID must be prefixed with “MV_” for movies or “TV_” for TV shows. This endpoint wraps TMDB’s images endpoints and passes through all supported query parameters. See TMDB Movie Images Documentation and TMDB TV Series Images Documentation for details. Query Parameters:
  • language: Filters results by language (ISO 639-1 code, e.g., “en”, “es”)
  • include_image_language: Includes additional languages (comma-separated ISO 639-1 codes, e.g., “en,es,fr”)

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe unique identifier of the media item (e.g., “MV_550”, “TV_1399”)
languagestringNoISO 639-1 language code to filter images by language. If specified, acts as a filter on returned items.
include_image_languagestringNoComma-separated ISO 639-1 language codes to include additional languages. Can be used with or without the language parameter.

​
Returns

MediaImagesResponse — Media images retrieved successfully 
{
  "id": 0,
  "backdrops": [
{
  "aspect_ratio": 0.0,
  "file_path": "string",
  "url": "string",
  "height": 0,
  "width": 0,
  "iso_639_1": "string",
  "vote_average": 0.0,
  "vote_count": 0
}
],
  "logos": [
{
  "aspect_ratio": 0.0,
  "file_path": "string",
  "url": "string",
  "height": 0,
  "width": 0,
  "iso_639_1": "string",
  "vote_average": 0.0,
  "vote_count": 0
}
],
  "posters": [
{
  "aspect_ratio": 0.0,
  "file_path": "string",
  "url": "string",
  "height": 0,
  "width": 0,
  "iso_639_1": "string",
  "vote_average": 0.0,
  "vote_count": 0
}
]
}

​
Example

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,es,fr" });
console.log(response);