Get movie details
get_movieRetrieve full movie details by TMDB ID: overview, genres, runtime, budget, revenue, age rating, and links to TMDB and IMDb. Optionally includes ratings from Rotten Tomatoes, Metacritic, and awards summary.
Instructions
Get full details for one movie by TMDB id: overview, genres, runtime, budget/revenue, vote average, the age/content rating (certification) for region — falling back to the US rating, then any available country, when region has none; check certification_region to see which one was used — and links (TMDB + IMDb). By default also includes IMDb/Rotten Tomatoes/Metacritic ratings, an awards summary (major-award wins/nominations — Oscars, Emmys, Golden Globes, etc.; free text, not a structured count, for the whole film/show, not one person), and OMDb's own age rating (ratings.rated — separate from this tool's own certification above; the two can differ) from OMDb (set include_ratings=false to skip); if unavailable (no OMDB_API_KEY, no imdb_id, or the OMDb lookup fails), ratings degrades to {found:false, reason} instead of failing the call. If you only need the headline info (title/year/genres/vote average) — for one id or several — use get_movies instead; it's trimmed on purpose and skips the rest of this payload. Get the id from search_movies.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | TMDB numeric id. | |
| region | No | ISO-3166-1 country code for region-specific results (default 'US'). | |
| language | No | Override the response language (ISO-639-1, optionally with a region), e.g. 'ru-RU' or 'en-US'. Localizes titles/overviews/genre names. Defaults to the server's TMDB_LANGUAGE. | |
| include_ratings | No | If true (default), enrich the result with IMDb/Rotten Tomatoes/Metacritic ratings plus an awards summary (major-award wins/nominations — Oscars, Emmys, Golden Globes, etc., whatever OMDb aggregates; free text, not a structured count, and describes the whole film/show, not any one person's award) from OMDb (requires OMDB_API_KEY). Set false to skip the extra lookup when ratings are not needed. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| year | Yes | ||
| title | No | ||
| genres | Yes | ||
| status | Yes | ||
| imdb_id | Yes | ||
| ratings | No | ||
| tagline | Yes | ||
| homepage | Yes | ||
| imdb_url | Yes | ||
| overview | Yes | ||
| tmdb_url | Yes | ||
| budget_usd | Yes | ||
| collection | Yes | ||
| media_type | Yes | ||
| popularity | Yes | ||
| poster_url | Yes | ||
| vote_count | Yes | ||
| revenue_usd | Yes | ||
| release_date | Yes | ||
| vote_average | Yes | ||
| certification | Yes | ||
| certifications | Yes | ||
| origin_country | Yes | ||
| original_title | No | ||
| runtime_minutes | Yes | ||
| spoken_languages | Yes | ||
| original_language | Yes | ||
| certification_region | Yes | ||
| production_companies | Yes |