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.

Searches for movies, TV shows, and persons using the TMDB multi-search API. Results are returned with transformed IDs:
  • TV shows: TV_{tmdb_id}
  • Movies: MV_{tmdb_id}
  • Persons: {tmdb_id} (unchanged)
Each result includes an explicit tmdb_id field with the original TMDB ID. Note: At least one of query or q parameters must be provided. If both are provided, query takes precedence.

​
Parameters

NameTypeRequiredDescription
querystringNoSearch query string (alternative to ‘q’). At least one of ‘query’ or ‘q’ must be provided. If both are provided, ‘query’ takes precedence.
qstringNoSearch query string (alternative to ‘query’). At least one of ‘query’ or ‘q’ must be provided.

​
Returns

SearchResponse — Search results retrieved successfully 
{
  "page": 0,
  "results": [
{
  "id": "string",
  "tmdb_id": 0,
  "media_type": "movie" /* enum: "movie", "tv", "person" */,
  "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,
  "profile_path": "string",
  "known_for_department": "string",
  "known_for": ["any"]
}
],
  "total_pages": 0,
  "total_results": 0
}

​
Example

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

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

// After sign-in and profile selection …
const response: SearchResponse = await discovr.searchMedia({ query: "avatar", q: "avatar" });
console.log(response);