# TMDB API

> TMDB returns movie, TV show, trending, and upcoming release data, available as a workflow and API.

TMDB's Get movie returns movie details, cast, trailers, releases, and viewing services from a title or link, with optional year and country. Get tv show returns show details, cast, seasons, episodes, and viewing services from a show name or link, with optional country. List trending returns homepage movie and TV titles by period; List upcoming movies returns country-specific theatrical releases for three weeks.

- Page: https://fous.com/tools/tmdb
- Handle: `@tmdb`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://themoviedb.org
- Last verified: Sep 29, 2026

## Methods

### Get movie

Operation `get_movie`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find a movie by title or TMDB link and return its details, cast, trailers, and country-specific releases and viewing services. IMDb IDs are not shown on public movie pages.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `1933` | Release year to distinguish similarly named movies, for example 2024. |
| `title` | string | yes | `"King Kong"` | Movie name or TMDB movie link, for example Dune: Part Two. |
| `country` | string | no | `"GB"` | Country name or two-letter code for releases, ratings and watching options, for example France or FR. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release year to distinguish similarly named movies, for example 2024.",
      "examples": [
        1933
      ]
    },
    "title": {
      "type": "string",
      "description": "Movie name or TMDB movie link, for example Dune: Part Two.",
      "examples": [
        "King Kong",
        "Dune: Part Two",
        "https://www.themoviedb.org/movie/496243-parasite"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for releases, ratings and watching options, for example France or FR.",
      "examples": [
        "GB",
        "France"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "year": 1933,
      "title": "King Kong",
      "country": "GB"
    },
    {
      "title": "Dune: Part Two"
    },
    {
      "title": "https://www.themoviedb.org/movie/496243-parasite",
      "country": "France"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cast` | array |  |  |
| `cast[].actor` | string or null | `"Robert Armstrong"` |  |
| `cast[].character` | string or null | `"Carl Denham"` |  |
| `title` | string | `"King Kong"` |  |
| `budget` | object or null |  |  |
| `budget.amount` | number | `672000` |  |
| `budget.currency` | string | `"USD"` |  |
| `genres` | array |  |  |
| `revenue` | object or null |  |  |
| `revenue.amount` | number | `10001781` |  |
| `revenue.currency` | string | `"USD"` |  |
| `runtime` | string or null | `"1h 40m"` |  |
| `tagline` | string or null | `"Beauty conquered the beast!"` |  |
| `tmdb_id` | integer | `244` |  |
| `writers` | array |  |  |
| `overview` | string or null | `"Adventurous filmmaker Carl Denham sets out to produce a motion picture unlike anything the world has seen before. Along` |  |
| `trailers` | array |  |  |
| `trailers[].link` | string | `"https://www.youtube.com/watch?v=H0WpKl2A_2k"` |  |
| `trailers[].title` | string | `"King Kong Trailer (1933)"` |  |
| `directors` | array |  |  |
| `tmdb_link` | string | `"https://www.themoviedb.org/movie/244-king-kong"` |  |
| `age_rating` | string or null | `"PG"` |  |
| `release_date` | string or null | `"1933-06-23"` |  |
| `original_title` | string or null | `"King Kong"` |  |
| `where_to_watch` | array |  |  |
| `number_of_votes` | integer or null | `1671` |  |
| `original_language` | string or null | `"English"` |  |
| `poster_image_link` | string or null | `"https://media.themoviedb.org/t/p/original/lHlnxKL5GbgRibyRFI7n1Ey850i.jpg"` |  |
| `user_score_percent` | integer or null | `76` |  |
| `backdrop_image_link` | string or null | `"https://media.themoviedb.org/t/p/original/lYfHa1AtkUMtplrKx7SRLHpwonW.jpg"` |  |

**Example input**

```json
{
  "year": 1933,
  "title": "King Kong",
  "country": "GB"
}
```

**Example output**

```json
{
  "cast": [
    {
      "actor": "Robert Armstrong",
      "character": "Carl Denham"
    },
    {
      "actor": "Fay Wray",
      "character": "Ann Darrow"
    },
    {
      "actor": "Bruce Cabot",
      "character": "Jack Driscoll"
    }
  ],
  "title": "King Kong",
  "budget": {
    "amount": 672000,
    "currency": "USD"
  },
  "genres": [
    "Adventure",
    "Fantasy",
    "Horror"
  ],
  "revenue": {
    "amount": 10001781,
    "currency": "USD"
  },
  "runtime": "1h 40m",
  "tagline": "Beauty conquered the beast!",
  "tmdb_id": 244,
  "writers": [
    "James Ashmore Creelman",
    "Ruth Rose"
  ],
  "overview": "Adventurous filmmaker Carl Denham sets out to produce a motion picture unlike anything the world has seen before. Alongside his leading lady Ann Darrow and his first mate Jack Driscoll, they arrive on…",
  "trailers": [
    {
      "link": "https://www.youtube.com/watch?v=H0WpKl2A_2k",
      "title": "King Kong Trailer (1933)"
    },
    {
      "link": "https://www.youtube.com/watch?v=I8P7RzqOU_M",
      "title": "Trailer"
    }
  ],
  "directors": [
    "Ernest B. Schoedsack",
    "Merian C. Cooper"
  ],
  "tmdb_link": "https://www.themoviedb.org/movie/244-king-kong",
  "age_rating": "PG",
  "release_date": "1933-06-23",
  "original_title": "King Kong",
  "where_to_watch": [
    "Amazon Prime Video",
    "Amazon Prime Video with Ads",
    "BBC iPlayer"
  ],
  "number_of_votes": 1671,
  "original_language": "English",
  "poster_image_link": "https://media.themoviedb.org/t/p/original/lHlnxKL5GbgRibyRFI7n1Ey850i.jpg",
  "user_score_percent": 76,
  "backdrop_image_link": "https://media.themoviedb.org/t/p/original/lYfHa1AtkUMtplrKx7SRLHpwonW.jpg"
}
```

### Get tv show

Operation `get_tv_show`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a TV show’s details, cast, seasons, episodes, and country-specific viewing services by name or TMDB link. Future and unaired episode details depend on the show’s published schedule.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `show` | string | yes | `"The Bear"` | Show name or TMDB show link, for example The Bear or https://www.themoviedb.org/tv/136315-the-bear. |
| `country` | string | no | `"Canada"` | Country name or two-letter code for viewing services, for example Canada or CA. Defaults to United States. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "show"
  ],
  "properties": {
    "show": {
      "type": "string",
      "description": "Show name or TMDB show link, for example The Bear or https://www.themoviedb.org/tv/136315-the-bear.",
      "examples": [
        "The Bear",
        "https://www.themoviedb.org/tv/456-the-simpsons"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for viewing services, for example Canada or CA. Defaults to United States.",
      "examples": [
        "Canada"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "show": "The Bear"
    },
    {
      "show": "https://www.themoviedb.org/tv/456-the-simpsons",
      "country": "Canada"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cast` | array |  | Up to 15 top-billed cast members. |
| `cast[].name` | string | `"Jeremy Allen White"` | Actor name. |
| `cast[].character` | string or null | `"Carmen 'Carmy' Berzatto"` | Character name. |
| `name` | string | `"The Bear"` | Show name. |
| `genres` | array |  | Genres. |
| `status` | string or null | `"ended"` | Returning series, ended, or canceled. |
| `seasons` | array |  | Seasons, including specials when listed. |
| `seasons[].name` | string | `"Season 1"` | Season name. |
| `seasons[].number` | integer | `1` | Season number. |
| `seasons[].air_date` | string or null | `"2022-06-23"` | Premiere date, YYYY-MM-DD, if listed. |
| `seasons[].episode_count` | integer | `8` | Episode count. |
| `tmdb_id` | integer | `136315` | TMDB show ID. |
| `creators` | array |  | Show creators. |
| `networks` | array |  | Broadcast networks. |
| `overview` | string or null | `"Carmy, a young fine-dining chef, comes home to Chicago to run his family sandwich shop. As he fights to transform the s` | Show summary. |
| `tmdb_link` | string | `"https://www.themoviedb.org/tv/136315-the-bear"` | Show page link on TMDB. |
| `poster_link` | string or null | `"https://image.tmdb.org/t/p/w500/eKfVzzEazSIjJMrw9ADa2x8ksLz.jpg"` | Show poster image link. |
| `next_episode` | any |  | Next scheduled episode, if listed. |
| `last_air_date` | string or null | `"2026-06-25"` | Last recorded air date, YYYY-MM-DD. |
| `first_air_date` | string or null | `"2022-06-23"` | Date the series first aired, YYYY-MM-DD. |
| `where_to_watch` | array |  | Services listed for the chosen country. |
| `number_of_seasons` | integer | `5` | Number of regular seasons. |
| `last_episode_aired` | any |  | Most recently aired episode, if listed. |
| `number_of_episodes` | integer | `46` | Number of episodes. |
| `user_score_percent` | integer or null | `82` | TMDB user score as a percentage. |

**Example input**

```json
{
  "show": "The Bear"
}
```

**Example output**

```json
{
  "cast": [
    {
      "name": "Jeremy Allen White",
      "character": "Carmen 'Carmy' Berzatto"
    },
    {
      "name": "Ebon Moss-Bachrach",
      "character": "Richard 'Richie' Jerimovich"
    },
    {
      "name": "Ayo Edebiri",
      "character": "Sydney Adamu"
    }
  ],
  "name": "The Bear",
  "genres": [
    "Drama",
    "Comedy"
  ],
  "status": "ended",
  "seasons": [
    {
      "name": "Season 1",
      "number": 1,
      "air_date": "2022-06-23",
      "episode_count": 8
    },
    {
      "name": "Season 2",
      "number": 2,
      "air_date": "2023-06-22",
      "episode_count": 10
    },
    {
      "name": "Season 3",
      "number": 3,
      "air_date": "2024-06-26",
      "episode_count": 10
    }
  ],
  "tmdb_id": 136315,
  "creators": [
    "Christopher Storer"
  ],
  "networks": [
    "Hulu"
  ],
  "overview": "Carmy, a young fine-dining chef, comes home to Chicago to run his family sandwich shop. As he fights to transform the shop and himself, he works alongside a rough-around-the-edges crew that ultimately…",
  "tmdb_link": "https://www.themoviedb.org/tv/136315-the-bear",
  "poster_link": "https://image.tmdb.org/t/p/w500/eKfVzzEazSIjJMrw9ADa2x8ksLz.jpg",
  "next_episode": null,
  "last_air_date": "2026-06-25",
  "first_air_date": "2022-06-23",
  "where_to_watch": [
    "Hulu",
    "Disney Plus",
    "YouTube TV"
  ],
  "number_of_seasons": 5,
  "last_episode_aired": {
    "title": "The Original Beef of Chicagoland",
    "season": 5,
    "air_date": "2026-06-25",
    "episode_number": 8
  },
  "number_of_episodes": 46,
  "user_score_percent": 82
}
```

### List trending

Operation `list_trending`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List TMDB homepage trending titles for today or this week, in displayed order, with scores and overviews. The homepage publishes up to 20 mixed movie and TV titles per period; movie and TV filters select from those 20, and trending people or later ranks are not available there.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `what` | string | no | `"all"` | Which trending titles to include, for example movies. People are not listed on the public trending homepage. |
| `period` | string | no | `"today"` | Time period to display, for example this_week. |
| `max_results` | integer | no | `5` | Maximum number of entries to return, for example 10. The public homepage lists only 20 mixed titles per period. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "what": {
      "enum": [
        "all",
        "movies",
        "tv"
      ],
      "type": "string",
      "default": "all",
      "description": "Which trending titles to include, for example movies. People are not listed on the public trending homepage.",
      "examples": [
        "all",
        "tv",
        "movies"
      ]
    },
    "period": {
      "enum": [
        "today",
        "this_week"
      ],
      "type": "string",
      "default": "today",
      "description": "Time period to display, for example this_week.",
      "examples": [
        "today",
        "this_week"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of entries to return, for example 10. The public homepage lists only 20 mixed titles per period.",
      "x-fous-developer": true,
      "examples": [
        5,
        4,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "what": "all",
      "period": "today",
      "max_results": 5
    },
    {
      "what": "tv",
      "period": "this_week",
      "max_results": 4
    },
    {
      "what": "movies",
      "period": "today",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `trending` | array |  | Titles in the homepage trending order. |
| `trending[].rank` | integer | `1` | Position on the homepage trending list. |
| `trending[].type` | string | `"movie"` | Type of title. |
| `trending[].year` | integer or null | `2026` | Release or premiere year, if available. |
| `trending[].title` | string | `"Runner"` | Movie or show title. |
| `trending[].overview` | string or null | `"A former soldier is thrown into a brutal race against time when a critical medical delivery makes him and his unlikely ` | Summary from the title page. |
| `trending[].tmdb_link` | string | `"https://www.themoviedb.org/movie/1377237-runner"` | Title page link. |
| `trending[].user_score` | integer or null | `77` | TMDB user score as a percentage. |
| `trending[].poster_link` | string or null | `"https://media.themoviedb.org/t/p/w220_and_h330_face/yBKMAIj7clP42UkFejhGDBBoTpb.jpg"` | Poster image link. |

**Example input**

```json
{
  "what": "all",
  "period": "today",
  "max_results": 5
}
```

**Example output**

```json
{
  "trending": [
    {
      "rank": 1,
      "type": "movie",
      "year": 2026,
      "title": "Runner",
      "overview": "A former soldier is thrown into a brutal race against time when a critical medical delivery makes him and his unlikely partner the targets of a ruthless cartel. As the mission spirals into a deadly ma…",
      "tmdb_link": "https://www.themoviedb.org/movie/1377237-runner",
      "user_score": 77,
      "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/yBKMAIj7clP42UkFejhGDBBoTpb.jpg"
    },
    {
      "rank": 2,
      "type": "TV show",
      "year": 2026,
      "title": "Lanterns",
      "overview": "Two intergalactic cops, new recruit John Stewart and Lantern legend Hal Jordan, are drawn into a dark, Earth-based mystery as they investigate a murder in the American heartland.",
      "tmdb_link": "https://www.themoviedb.org/tv/95350-lanterns",
      "user_score": 83,
      "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/gpC7h43xPMEV3goYMQShfJbTtLq.jpg"
    },
    {
      "rank": 3,
      "type": "movie",
      "year": 2026,
      "title": "Digger",
      "overview": "The most powerful man in the world embarks on a frantic mission to prove he is humanity's savior before the disaster he's unleashed destroys everything.",
      "tmdb_link": "https://www.themoviedb.org/movie/1248832-digger",
      "user_score": 81,
      "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/1ATXKrIPJyKNwnJ6lcG088Sa6zi.jpg"
    }
  ]
}
```

### List upcoming movies

Operation `list_upcoming_movies`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List movies scheduled for theatrical release in a country over the coming three weeks, soonest first. Dates are confirmed from the country-specific release calendar; details may be missing for unpublished titles.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"United Kingdom"` | Country name or two-letter country code, such as United States or US. |
| `max_results` | integer | no | `4` | Maximum movies to return, such as 20 (up to 100). |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, such as United States or US.",
      "examples": [
        "United Kingdom",
        "United States"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum movies to return, such as 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        4,
        20
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "country": "United Kingdom",
      "max_results": 4
    },
    {
      "country": "United States",
      "max_results": 20
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `movies` | array |  | Upcoming theatrical movies sorted by release date in the selected country. |
| `movies[].title` | string | `"LINKIN PARK: UNSHATTER"` |  |
| `movies[].genres` | array |  |  |
| `movies[].overview` | string or null | `"In 1986 Madras, a timid eight-year-old boy accidentally traps a feared gangster inside a deserted school toilet. As the` |  |
| `movies[].tmdb_link` | string | `"https://www.themoviedb.org/movie/1388805-linkin-park-unshatter"` |  |
| `movies[].poster_link` | string or null | `"https://media.themoviedb.org/t/p/w116_and_h174_face/kHNrz7DBVPrtyMhJxmBm2poS2l9.jpg"` |  |
| `movies[].release_date` | string | `"2026-09-30"` |  |
| `movies[].user_score_percent` | integer or null | `78` |  |

**Example input**

```json
{
  "country": "United Kingdom",
  "max_results": 4
}
```

**Example output**

```json
{
  "movies": [
    {
      "title": "LINKIN PARK: UNSHATTER",
      "genres": [
        "Music",
        "Documentary"
      ],
      "overview": "After a seven-year hiatus following the devastating loss of their beloved bandmate Chester Bennington, LINKIN PARK'S remaining members struggled to find their way forward. Their shared history and end…",
      "tmdb_link": "https://www.themoviedb.org/movie/1388805-linkin-park-unshatter",
      "poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/kHNrz7DBVPrtyMhJxmBm2poS2l9.jpg",
      "release_date": "2026-09-30",
      "user_score_percent": null
    },
    {
      "title": "Baththa",
      "genres": [
        "Thriller",
        "Drama"
      ],
      "overview": "In 1986 Madras, a timid eight-year-old boy accidentally traps a feared gangster inside a deserted school toilet. As the gangster is forced to confront hunger, loneliness and his own vulnerability, an …",
      "tmdb_link": "https://www.themoviedb.org/movie/1515692",
      "poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/bsFSlIwsH0Lrqo9TtGv4KwvgKS1.jpg",
      "release_date": "2026-10-01",
      "user_score_percent": null
    },
    {
      "title": "Nightmares",
      "genres": [
        "Drama",
        "Thriller"
      ],
      "overview": "The true story that became the basis one of the greatest horror movies of all time, following a journalist attempting to uncover the truth behind several unexplained deaths",
      "tmdb_link": "https://www.themoviedb.org/movie/1505441-nightmares",
      "poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/iBGo3tzQ2fesULpZWlUYgOWASac.jpg",
      "release_date": "2026-10-01",
      "user_score_percent": null
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@tmdb",
  "visibility": "public",
  "operation": "get_movie",
  "version": 1,
  "input": {
    "year": 1933,
    "title": "King Kong",
    "country": "GB"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@tmdb\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_movie\",\n  \"version\": 1,\n  \"input\": {\n    \"year\": 1933,\n    \"title\": \"King Kong\",\n    \"country\": \"GB\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@tmdb",
  "visibility": "public",
  "operation": "get_movie",
  "version": 1,
  "input": {
    "year": 1933,
    "title": "King Kong",
    "country": "GB"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/tmdb`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_movie`: Get movie. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_tv_show`: Get tv show. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_trending`: List trending. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_upcoming_movies`: List upcoming movies. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-tmdb https://api.fous.com/mcp/tools/tmdb --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare movie casts, genres, runtimes, and user scores.
- Find where movies and TV shows are available by country.
- Track TV show seasons, episodes, and air dates.
- Monitor trending movie and TV titles by period.
- Plan around upcoming theatrical releases in a country.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this TMDB tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a TMDB account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from themoviedb.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### Who is in a movie's cast?

Get movie returns cast members and their characters.

### What is the next scheduled episode?

Get tv show returns the next scheduled episode, if listed.

### Which movies are coming to theaters in a country?

List upcoming movies returns scheduled theatrical releases for the selected country over the coming three weeks.

## Related

- [TVmaze API](https://fous.com/tools/tvmaze.md): TVmaze provides TV schedules, broadcast and streaming releases, and show status, ratings, and episode details; streaming times may be unavailable or shown in UTC.
- [IMDb API](https://fous.com/tools/imdb.md): IMDb returns movie, TV, person, episode, chart and Parents Guide details, including available weekly rank changes; missing details are null, and unaired or unrated episodes lack ratings.
- [Letterboxd API](https://fous.com/tools/letterboxd.md): Letterboxd provides films with ratings, cast, location-dependent watch services and popular reviews, plus popularity-ranked lists by time period, genre and decade; some details may be unavailable.
- [Rotten Tomatoes API](https://fous.com/tools/rotten-tomatoes.md): Rotten Tomatoes returns movie and TV details, scores, newest reviews, and listings for theaters, coming soon, or at home; series rating counts may be unavailable.
- [Netflix API](https://fous.com/tools/netflix.md): Netflix offers weekly global and country Top 10 rankings, all-time popularity rankings based on titles’ first 91 days, and title details with country availability that may lag.
- [Fandango API](https://fous.com/tools/fandango.md): Fandango provides nearby U.S. movie showtimes, formats, local times and ticket links; theater listings for selected dates when available; and movies now playing or coming soon with details when listed.
- [JustWatch API](https://fous.com/tools/justwatch.md): JustWatch shows where movies and shows are available, including streaming, purchase, and cinema options, plus recent streaming arrivals and daily streaming charts based on its listings.
- [Box Office Mojo API](https://fous.com/tools/box-office-mojo.md): Box Office Mojo reports weekend rankings, movie details, daily grosses, and annual leaders; weekend and daily results default to the latest reported period, with some international figures unavailable.
- [All Entertainment tools](https://fous.com/tools/category/entertainment)