# IMDb API

> IMDb returns movie, show, person, episode, chart, and Parents Guide data as a workflow and API.

IMDb's Get movie or show returns title details from a title, link, or ID; year can distinguish matches. Get person takes a person's name, IMDb link, or ID; List top charts takes a chart and optional result count. Get episode ratings takes a series and optional season; Get parents guide takes a title, link, or ID, with an optional year.

- Page: https://fous.com/workflows/imdb
- Handle: `@imdb`
- Category: [Entertainment](https://fous.com/workflows/category/entertainment)
- Source website: https://imdb.com
- Last verified: Sep 30, 2026
- Fous is not affiliated with IMDb.

## Methods

### Get episode ratings

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

List every episode of an IMDb TV series in season and episode order, with air dates, ratings, votes, plots and links. Optionally select one season; unrated or unaired episodes have no rating.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `season` | integer | no | `2` | Season number, for example 2. Default 0 means all seasons. |
| `series` | string | yes | `"The Office"` | TV series name, IMDb title link, or title ID, for example Breaking Bad. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "series"
  ],
  "properties": {
    "season": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Season number, for example 2. Default 0 means all seasons.",
      "examples": [
        2,
        5,
        1
      ]
    },
    "series": {
      "type": "string",
      "description": "TV series name, IMDb title link, or title ID, for example Breaking Bad.",
      "examples": [
        "The Office",
        "Breaking Bad",
        "https://www.imdb.com/title/tt0903747/"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "season": 2,
      "series": "The Office"
    },
    {
      "series": "Breaking Bad"
    },
    {
      "season": 5,
      "series": "https://www.imdb.com/title/tt0903747/"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `episodes` | array |  |  |
| `episodes[].air_date` | string or null | `"2012-07-15"` |  |
| `episodes[].episode_id` | string | `"tt2081647"` |  |
| `episodes[].short_plot` | string or null | `"After a deadly showdown, Walt and Jesse race to destroy evidence that could expose them, drawing Mike into a daring pla` |  |
| `episodes[].imdb_rating` | number or null | `9.2` | IMDb rating out of 10; null if unrated or unaired. |
| `episodes[].episode_link` | string | `"https://www.imdb.com/title/tt2081647/"` |  |
| `episodes[].episode_title` | string or null | `"Live Free or Die"` |  |
| `episodes[].season_number` | integer or null | `5` | Season number, if known. |
| `episodes[].episode_number` | integer or null | `1` | Episode number within the season, if known. |
| `episodes[].number_of_votes` | integer or null | `66283` |  |
| `imdb_link` | string | `"https://www.imdb.com/title/tt0903747/"` |  |
| `year_range` | string or null | `"2008–2013"` |  |
| `series_title` | string | `"Breaking Bad"` |  |
| `number_of_seasons` | integer | `5` |  |

**Example input**

```json
{
  "season": 5,
  "series": "https://www.imdb.com/title/tt0903747/"
}
```

**Example output**

```json
{
  "episodes": [
    {
      "air_date": "2012-07-15",
      "episode_id": "tt2081647",
      "short_plot": "After a deadly showdown, Walt and Jesse race to destroy evidence that could expose them, drawing Mike into a daring plan, while Skyler faces a frightening new reality at home.",
      "imdb_rating": 9.2,
      "episode_link": "https://www.imdb.com/title/tt2081647/",
      "episode_title": "Live Free or Die",
      "season_number": 5,
      "episode_number": 1,
      "number_of_votes": 66283
    },
    {
      "air_date": "2012-07-22",
      "episode_id": "tt2301457",
      "short_plot": "As Walt and Jesse seek Mike's help to rebuild their business, Gus's former associates face mounting scrutiny, while a Madrigal executive scrambles to contain the fallout.",
      "imdb_rating": 8.8,
      "episode_link": "https://www.imdb.com/title/tt2301457/",
      "episode_title": "Madrigal",
      "season_number": 5,
      "episode_number": 2,
      "number_of_votes": 58669
    },
    {
      "air_date": "2012-07-29",
      "episode_id": "tt2301459",
      "short_plot": "Walt, Jesse, and Mike devise an unconventional way to restart production, but disputes over money strain their new partnership, while Skyler struggles with Walt's return home.",
      "imdb_rating": 8.8,
      "episode_link": "https://www.imdb.com/title/tt2301459/",
      "episode_title": "Hazard Pay",
      "season_number": 5,
      "episode_number": 3,
      "number_of_votes": 58155
    }
  ],
  "imdb_link": "https://www.imdb.com/title/tt0903747/",
  "year_range": "2008–2013",
  "series_title": "Breaking Bad",
  "number_of_seasons": 5
}
```

### Get movie or show

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

Get a movie or TV show’s IMDb details from its name, link, or title ID. A year can distinguish titles with the same name; unavailable details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `2023` | Release or first aired year to distinguish matching names, e.g. 2023. |
| `title` | string | yes | `"Breaking Bad"` | Movie or show name, IMDb title link, or title ID, e.g. Oppenheimer or tt15398776. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release or first aired year to distinguish matching names, e.g. 2023.",
      "examples": [
        2023,
        1980
      ]
    },
    "title": {
      "type": "string",
      "description": "Movie or show name, IMDb title link, or title ID, e.g. Oppenheimer or tt15398776.",
      "examples": [
        "Breaking Bad",
        "Oppenheimer",
        "https://www.imdb.com/title/tt15398776/"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "title": "Breaking Bad"
    },
    {
      "year": 2023,
      "title": "Oppenheimer"
    },
    {
      "title": "https://www.imdb.com/title/tt15398776/"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cast` | array |  |  |
| `cast[].actor` | string | `"Bryan Cranston"` |  |
| `cast[].character` | string or null | `"Walter White"` |  |
| `type` | string or null | `"TV series"` |  |
| `year` | integer or null | `2008` |  |
| `title` | string or null | `"Breaking Bad"` |  |
| `budget` | object or null |  |  |
| `budget.amount` | number | `100000000` |  |
| `budget.currency` | string | `"USD"` |  |
| `genres` | array |  |  |
| `runtime` | string or null | `"48 min"` |  |
| `writers` | array |  |  |
| `countries` | array |  |  |
| `directors` | array |  |  |
| `imdb_link` | string | `"https://www.imdb.com/title/tt0903747/"` |  |
| `languages` | array |  |  |
| `metascore` | integer or null | `90` |  |
| `age_rating` | string or null | `"TV-MA"` |  |
| `vote_count` | integer or null | `2682966` |  |
| `imdb_rating` | number or null | `9.5` | IMDb user rating out of 10. |
| `years_aired` | string or null | `"2008–2013"` |  |
| `plot_summary` | string or null | `"A chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine with a for` |  |
| `release_date` | string or null | `"2008-01-20"` |  |
| `imdb_title_id` | string | `"tt0903747"` |  |
| `awards_summary` | string or null | `"Won 16 Primetime Emmys. 172 wins and 269 nominations total."` |  |
| `runtime_minutes` | integer or null | `48` |  |
| `worldwide_gross` | object or null |  |  |
| `worldwide_gross.amount` | number | `975811333` |  |
| `worldwide_gross.currency` | string | `"USD"` |  |
| `poster_image_link` | string or null | `"https://m.media-amazon.com/images/M/MV5BMzU5ZGYzNmQtMTdhYy00OGRiLTg0NmQtYjVjNzliZTg1ZGE4XkEyXkFqcGc@._V1_.jpg"` |  |

**Example input**

```json
{
  "title": "Breaking Bad"
}
```

**Example output**

```json
{
  "cast": [
    {
      "actor": "Bryan Cranston",
      "character": "Walter White"
    },
    {
      "actor": "Aaron Paul",
      "character": "Jesse Pinkman"
    },
    {
      "actor": "Anna Gunn",
      "character": "Skyler White"
    }
  ],
  "type": "TV series",
  "year": 2008,
  "title": "Breaking Bad",
  "budget": null,
  "genres": [
    "Crime",
    "Drama",
    "Thriller"
  ],
  "runtime": "48 min",
  "writers": [
    "Vince Gilligan"
  ],
  "countries": [
    "United States"
  ],
  "directors": [],
  "imdb_link": "https://www.imdb.com/title/tt0903747/",
  "languages": [
    "English",
    "Spanish"
  ],
  "metascore": null,
  "age_rating": "TV-MA",
  "vote_count": 2682966,
  "imdb_rating": 9.5,
  "years_aired": "2008–2013",
  "plot_summary": "A chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine with a former student to secure his family's future.",
  "release_date": "2008-01-20",
  "imdb_title_id": "tt0903747",
  "awards_summary": "Won 16 Primetime Emmys. 172 wins and 269 nominations total.",
  "runtime_minutes": 48,
  "worldwide_gross": null,
  "poster_image_link": "https://m.media-amazon.com/images/M/MV5BMzU5ZGYzNmQtMTdhYy00OGRiLTg0NmQtYjVjNzliZTg1ZGE4XkEyXkFqcGc@._V1_.jpg"
}
```

### Get parents guide

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

Get age certifications and non-spoiler Parents Guide summaries for a movie or show by title, link, or IMDb ID. A year can identify a specific release.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `1995` | Release or first-air year to select a matching title, such as 2016. |
| `title` | string | yes | `"Deadpool"` | Movie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release or first-air year to select a matching title, such as 2016.",
      "examples": [
        1995,
        2005
      ]
    },
    "title": {
      "type": "string",
      "description": "Movie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045.",
      "examples": [
        "Deadpool",
        "https://www.imdb.com/title/tt0114709/",
        "The Office"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "title": "Deadpool"
    },
    {
      "year": 1995,
      "title": "https://www.imdb.com/title/tt0114709/"
    },
    {
      "year": 2005,
      "title": "The Office"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `year` | integer or null |  |  |
| `title` | string |  |  |
| `imdb_link` | string |  |  |
| `categories` | array |  |  |
| `categories[].category` | string |  |  |
| `categories[].severity` | string or null |  |  |
| `categories[].imdb_link` | string |  |  |
| `categories[].mild_votes` | integer |  |  |
| `categories[].none_votes` | integer |  |  |
| `categories[].severe_votes` | integer |  |  |
| `categories[].moderate_votes` | integer |  |  |
| `categories[].example_descriptions` | array |  |  |
| `age_certifications` | array |  |  |
| `age_certifications[].notes` | string or null |  |  |
| `age_certifications[].rating` | string |  |  |
| `age_certifications[].country` | string |  |  |

### Get person

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

Find a film person by name or IMDb link or ID and get their biography, awards, and filmography. Credits exclude self-appearances, archive footage, and thanks.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `name` | string | yes | `"https://www.imdb.com/name/nm0634240/"` | The person’s name, IMDb person link, or person ID, for example Cillian Murphy. |
| `max_credits` | integer | no | `70` | Maximum number of credits to return, for example 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The person’s name, IMDb person link, or person ID, for example Cillian Murphy.",
      "examples": [
        "https://www.imdb.com/name/nm0634240/",
        "Cillian Murphy",
        "John Williams"
      ]
    },
    "max_credits": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of credits to return, for example 50.",
      "x-fous-developer": true,
      "examples": [
        70,
        20
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "name": "https://www.imdb.com/name/nm0634240/",
      "max_credits": 70
    },
    {
      "name": "Cillian Murphy"
    },
    {
      "name": "John Williams",
      "max_credits": 20
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Christopher Nolan"` |  |
| `imdb_link` | string | `"https://www.imdb.com/name/nm0634240/"` |  |
| `person_id` | string | `"nm0634240"` |  |
| `birth_date` | string or null | `"1970-07-30"` |  |
| `birthplace` | string or null | `"London, England, UK"` |  |
| `death_date` | string or null |  |  |
| `photo_link` | string or null | `"https://m.media-amazon.com/images/M/MV5BNjE3NDQyOTYyMV5BMl5BanBnXkFtZTcwODcyODU2Mw@@._V1_.jpg"` |  |
| `filmography` | array |  |  |
| `filmography[].type` | string | `"movie"` |  |
| `filmography[].year` | integer or null | `2026` |  |
| `filmography[].title` | string or null | `"The Odyssey"` |  |
| `filmography[].title_id` | string | `"tt33764258"` |  |
| `filmography[].imdb_link` | string | `"https://www.imdb.com/title/tt33764258/"` |  |
| `filmography[].imdb_rating` | number or null | `8.4` |  |
| `filmography[].role_or_job` | string | `"produced by; written for the screen by; Director; writer: \"When I'm Home\""` |  |
| `awards_summary` | string or null | `"2 Oscar wins; 6 Oscar nominations; 235 total wins; 302 other nominations"` |  |
| `short_biography` | string or null | `"Best known for his cerebral, often nonlinear, storytelling, acclaimed Academy Award winner writer/director/producer Sir` |  |
| `known_for_titles` | array |  |  |
| `main_professions` | array |  |  |

**Example input**

```json
{
  "name": "https://www.imdb.com/name/nm0634240/",
  "max_credits": 70
}
```

**Example output**

```json
{
  "name": "Christopher Nolan",
  "imdb_link": "https://www.imdb.com/name/nm0634240/",
  "person_id": "nm0634240",
  "birth_date": "1970-07-30",
  "birthplace": "London, England, UK",
  "death_date": null,
  "photo_link": "https://m.media-amazon.com/images/M/MV5BNjE3NDQyOTYyMV5BMl5BanBnXkFtZTcwODcyODU2Mw@@._V1_.jpg",
  "filmography": [
    {
      "type": "movie",
      "year": 2026,
      "title": "The Odyssey",
      "title_id": "tt33764258",
      "imdb_link": "https://www.imdb.com/title/tt33764258/",
      "imdb_rating": 8.4,
      "role_or_job": "produced by; written for the screen by; Director; writer: \"When I'm Home\""
    },
    {
      "type": "movie",
      "year": 2024,
      "title": "Sanatorium Under the Sign of the Hourglass",
      "title_id": "tt33069917",
      "imdb_link": "https://www.imdb.com/title/tt33069917/",
      "imdb_rating": 5.9,
      "role_or_job": "presenter"
    },
    {
      "type": "movie",
      "year": 2023,
      "title": "Oppenheimer",
      "title_id": "tt15398776",
      "imdb_link": "https://www.imdb.com/title/tt15398776/",
      "imdb_rating": 8.2,
      "role_or_job": "produced by; written for the screen by; Director"
    }
  ],
  "awards_summary": "2 Oscar wins; 6 Oscar nominations; 235 total wins; 302 other nominations",
  "short_biography": "Best known for his cerebral, often nonlinear, storytelling, acclaimed Academy Award winner writer/director/producer Sir Christopher Nolan CBE was born in London, England. Over the course of more than …",
  "known_for_titles": [
    "Tenet",
    "The Prestige",
    "Interstellar"
  ],
  "main_professions": [
    "Producer",
    "Writer",
    "Director"
  ]
}
```

### List top charts

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

List titles in an IMDb movie or TV chart, with ratings, votes, runtime, age rating and weekly rank movement where available. Popular charts contain up to 100 titles.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `chart` | string | no | `"top_250_tv_shows"` | Chart to list, for example top_250_movies. |
| `max_results` | integer | no | `5` | Maximum number of titles, for example 50. Popular charts have at most 100 titles. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "chart": {
      "enum": [
        "top_250_movies",
        "top_250_tv_shows",
        "most_popular_movies",
        "most_popular_tv_shows"
      ],
      "type": "string",
      "default": "top_250_movies",
      "description": "Chart to list, for example top_250_movies.",
      "examples": [
        "top_250_tv_shows",
        "top_250_movies",
        "most_popular_movies"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 250,
      "minimum": 1,
      "description": "Maximum number of titles, for example 50. Popular charts have at most 100 titles.",
      "x-fous-developer": true,
      "examples": [
        5,
        50,
        12
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "chart": "top_250_tv_shows",
      "max_results": 5
    },
    {
      "chart": "top_250_movies",
      "max_results": 50
    },
    {
      "chart": "most_popular_movies",
      "max_results": 12
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `titles` | array |  | Titles in chart order. |
| `titles[].rank` | integer | `1` | Position in the chosen chart. |
| `titles[].year` | integer or null | `2008` | First release year, if available. |
| `titles[].title` | string | `"Breaking Bad"` | Movie or show title. |
| `titles[].votes` | integer or null | `2682966` | Number of IMDb rating votes, if available. |
| `titles[].runtime` | string or null | `"48 min"` | Runtime, such as 2 h 22 min, if available. |
| `titles[].title_id` | string | `"tt0903747"` | IMDb title identifier. |
| `titles[].imdb_link` | string | `"https://www.imdb.com/title/tt0903747/"` | IMDb page for this title. |
| `titles[].age_rating` | string or null | `"TV-MA"` | Content rating, such as R or TV-MA, if available. |
| `titles[].imdb_rating` | number or null | `9.5` | IMDb audience rating out of 10, if available. |
| `titles[].runtime_minutes` | integer or null | `48` | Runtime in minutes, if available. |
| `titles[].rank_change_since_last_week` | integer or null | `0` | Weekly popularity chart rank change: positive means moved up, negative means moved down, zero means unchanged; null when unavailable or not a popularity chart. |

**Example input**

```json
{
  "chart": "top_250_tv_shows",
  "max_results": 5
}
```

**Example output**

```json
{
  "titles": [
    {
      "rank": 1,
      "year": 2008,
      "title": "Breaking Bad",
      "votes": 2682966,
      "runtime": "48 min",
      "title_id": "tt0903747",
      "imdb_link": "https://www.imdb.com/title/tt0903747/",
      "age_rating": "TV-MA",
      "imdb_rating": 9.5,
      "runtime_minutes": 48,
      "rank_change_since_last_week": null
    },
    {
      "rank": 2,
      "year": 2016,
      "title": "Planet Earth II",
      "votes": 177103,
      "runtime": "50 min",
      "title_id": "tt5491994",
      "imdb_link": "https://www.imdb.com/title/tt5491994/",
      "age_rating": "TV-G",
      "imdb_rating": 9.4,
      "runtime_minutes": 50,
      "rank_change_since_last_week": null
    },
    {
      "rank": 3,
      "year": 2006,
      "title": "Planet Earth",
      "votes": 237027,
      "runtime": "50 min",
      "title_id": "tt0795176",
      "imdb_link": "https://www.imdb.com/title/tt0795176/",
      "age_rating": "TV-PG",
      "imdb_rating": 9.4,
      "runtime_minutes": 50,
      "rank_change_since_last_week": 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": "@imdb",
  "visibility": "public",
  "operation": "get_episode_ratings",
  "version": 1,
  "input": {
    "season": 2,
    "series": "The Office"
  },
  "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\": \"@imdb\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_episode_ratings\",\n  \"version\": 1,\n  \"input\": {\n    \"season\": 2,\n    \"series\": \"The Office\"\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": "@imdb",
  "visibility": "public",
  "operation": "get_episode_ratings",
  "version": 1,
  "input": {
    "season": 2,
    "series": "The Office"
  },
  "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":"@imdb","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 ratings and runtimes across chart titles
- Research a film or show's cast, crew, and budget
- Review a person's biography, awards, and filmography
- Track episode ratings and air dates by season
- Assess age certifications and Parents Guide categories

## FAQ

### Is Fous affiliated with IMDb?

No. Fous is not affiliated with IMDb. This workflow reads the public imdb.com 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 IMDb account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from imdb.com 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 30, 2026.

### What is a movie or show's IMDb rating?

Get movie or show returns the IMDb user rating out of 10 for a title.

### Which episodes have ratings in a series?

Get episode ratings lists episodes with ratings, votes, air dates, and plots; you can select a season.

### What age certifications and content categories are listed?

Get parents guide returns age certifications and Parents Guide category summaries for a movie or show.

## Related

- [TMDB API](https://fous.com/workflows/tmdb.md): TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
- [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.
- [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.
- [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.
- [Common Sense Media API](https://fous.com/workflows/common-sense-media.md): Independent reviews and age guidance for family entertainment.
- [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.
- [Apple Podcasts API](https://fous.com/workflows/apple-podcasts.md): Apple Podcasts returns chart listings, relevant show search results, show details with newest available episodes, and country-specific ratings and reviews; results are capped, and older or subscription episodes may be unavailable.
- [All Entertainment workflows](https://fous.com/workflows/category/entertainment)