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 details 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.

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe unique identifier of the media item (e.g., “MV_550”, “TV_1399”)

​
Returns

MediaResponse — Media details retrieved successfully 
{
  "id": "string",
  "media_type": "movie" /* enum: "movie", "tv" */,
  "movie": {
  "id": "string",
  "tmdb_id": 0,
  "title": "string",
  "original_title": "string",
  "overview": "string",
  "poster_path": "string",
  "backdrop_path": "string",
  "release_date": "string" /* date */,
  "runtime": 0,
  "vote_average": 0.0,
  "vote_count": 0,
  "popularity": 0.0,
  "genres": [
{
  "tmdb_id": 0,
  "name": "string"
}
],
  "tagline": "string",
  "status": "string",
  "budget": 0,
  "revenue": 0,
  "homepage": "string",
  "imdb_id": "string"
},
  "tv": {
  "id": "string",
  "tmdb_id": 0,
  "name": "string",
  "original_name": "string",
  "overview": "string",
  "poster_path": "string",
  "backdrop_path": "string",
  "first_air_date": "string" /* date */,
  "last_air_date": "string" /* date */,
  "number_of_episodes": 0,
  "number_of_seasons": 0,
  "vote_average": 0.0,
  "vote_count": 0,
  "popularity": 0.0,
  "genres": [
{
  "tmdb_id": 0,
  "name": "string"
}
],
  "tagline": "string",
  "status": "string",
  "homepage": "string",
  "in_production": false,
  "seasons": [
{
  "tmdb_id": 0,
  "name": "string",
  "episode_count": 0,
  "season_number": 0,
  "air_date": "string" /* date */,
  "poster_path": "string"
}
]
}
}

​
Example

import { DiscovrClient } from "discovr";
import type { MediaResponse } from "discovr";

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

// After sign-in and profile selection …
const response: MediaResponse = await discovr.getMedia("example");
console.log(response);