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 similar movie or TV show recommendations from TMDB based on the provided media ID. Results are returned with transformed IDs:
  • TV shows: TV_{tmdb_id}
  • Movies: MV_{tmdb_id}
Each result includes an explicit tmdb_id field with the original TMDB ID. Image paths (poster_path, backdrop_path) are returned as full URLs.

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe unique identifier of the media item (e.g., “MV_550”, “TV_1399”)
languagestringNoLanguage code for the results (e.g., “en-US”)
pageintegerNoPage number for pagination (default: 1)

​
Returns

SimilarResponse — Recommendations retrieved successfully 
{
  "page": 0,
  "results": [
{
  "id": "string",
  "tmdb_id": 0,
  "media_type": "movie" /* enum: "movie", "tv" */,
  "title": "string",
  "name": "string",
  "original_title": "string",
  "original_name": "string",
  "overview": "string",
  "poster_path": "string",
  "backdrop_path": "string",
  "release_date": "string" /* date */,
  "first_air_date": "string" /* date */,
  "popularity": 0.0,
  "vote_average": 0.0,
  "vote_count": 0
}
],
  "total_pages": 0,
  "total_results": 0
}

​
Example

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

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

// After sign-in and profile selection …
const response: SimilarResponse = await discovr.getSimilarRecommendations("example", { language: "en-US", page: 1 });
console.log(response);