Skip to main content
GET
/
media
/
{mediaId}
/
similar
TypeScript
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);
{
  "results": [
    {
      "id": "TV_1396",
      "tmdb_id": 1396,
      "media_type": "movie",
      "title": "<string>",
      "name": "<string>",
      "original_title": "<string>",
      "original_name": "<string>",
      "overview": "<string>",
      "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "backdrop_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "release_date": "2023-12-25",
      "first_air_date": "2023-12-25",
      "popularity": 123,
      "vote_average": 123,
      "vote_count": 123
    }
  ],
  "page": 1,
  "total_pages": 10,
  "total_results": 100
}

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

Language code for results (e.g., en-US).

Example:

"en-US"

page
integer
default:1

Page number for pagination (default: 1).

Required range: x >= 1
Example:

1

Response

Similar titles returned successfully.

Paginated list of similar titles.

results
object[]
required

Similar titles for the current page.

page
integer

Current page number.

Example:

1

total_pages
integer

Total number of pages available.

Example:

10

total_results
integer

Total number of similar titles across all pages.

Example:

100