# 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/workflows/tmdb
- Handle: `@tmdb`
- Category: [Entertainment](https://fous.com/workflows/category/entertainment)
- Source website: https://themoviedb.org
- Last verified: Sep 29, 2026
- Fous is not affiliated with TMDB.

## Methods

### Get movie

Operation `get_movie`, version 1. 1 credit per call.

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 call.

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 call.

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 call.

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 |  |  |

**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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@tmdb","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with TMDB?

No. Fous is not affiliated with TMDB. This workflow reads the public themoviedb.org website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/entertainment)