# IMDb API: Get IMDb Parents Guide > Gets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release. Unofficial. Not affiliated with or endorsed by IMDb. - Page: https://fous.com/methods/imdb.com/get-parents-guide - Method: `imdb.com/get_parents_guide`, version 1 - Website: imdb.com - Returns: title, year, IMDb link, age certifications by country, Parents Guide categories with severity, vote counts and example descriptions - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `year` | integer | no | `2001` | Release or first-air year to select a matching title, such as 2016. | | `title` | string | yes | `"The Office"` | Movie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "year": 2001, "title": "The Office" } ``` Its output: ```json { "year": 2001, "title": "The Office", "imdb_link": "https://www.imdb.com/title/tt0290978/parentalguide/", "categories": [ { "category": "Sex and Nudity", "severity": "moderate", "imdb_link": "https://www.imdb.com/title/tt0290978/parentalguide/#nudity", "mild_votes": 24, "none_votes": 8, "severe_votes": 6, "moderate_votes": 29, "example_descriptions": [ "Chris Finch makes sexual references in all of his appearances, and has sexual intercourse in a short, 10 second end credits scene. Played for laughs.", "The \"Party\" episode often features a dildo, in one scene it is accidentally turned on and it spins around. It is never used in a sexual context. Played for laughs", "Season one, episode three (\"The Quiz\"): someone gets a life-size inflatable penis as a gift, and multiple characters joke about it. This scene lasts for about 30 seconds. Near the end of the episode, it's kicked around by Gareth for a couple of seconds." ] }, { "category": "Violence and Gore", "severity": "none", "imdb_link": "https://www.imdb.com/title/tt0290978/parentalguide/#violence", "mild_votes": 3, "none_votes": 39, "severe_votes": 1, "moderate_votes": 0, "example_descriptions": [ "extremely rare slapstick" ] }, { "category": "Profanity", "severity": "moderate", "imdb_link": "https://www.imdb.com/title/tt0290978/parentalguide/#profanity", "mild_votes": 3, "none_votes": 3, "severe_votes": 33, "moderate_votes": 32, "example_descriptions": [ "Frequent crude language regarding manual stimulation", "Stronger language than The Office US (which is, for the most part, censored.)", "Contains only occasional use of strong language such as fuck, shit, bitch, cock, wanker and one use of cunt in the second season." ] } ], "age_certifications": [ { "notes": null, "rating": "13", "country": "Argentina" }, { "notes": null, "rating": "M", "country": "Australia" }, { "notes": null, "rating": "12", "country": "Brazil" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"imdb.com/get_parents_guide","input":{"year":2001,"title":"The Office"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Is Oppenheimer okay for my 13-year-old? I want to know how bad the nudity and violence are and what it's rated in different countries. - Check IMDb's parents guide for tt0944947 — what are the severity ratings for sex, violence, profanity, drugs and frightening scenes? - How much swearing and gore is in the 2018 Halloween movie? Need severity votes and some example descriptions, no spoilers. - What age ratings did Euphoria get around the world, and how intense is the drug and sexual content according to IMDb users? - Content advisory for The Batman (2022): certifications by country plus how viewers rated the frightening and intense scenes. ## 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." }, "title": { "type": "string", "minLength": 1, "description": "Movie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045." } } } ``` ## Output schema ```json { "type": "object", "required": [ "title", "year", "imdb_link", "age_certifications", "categories" ], "properties": { "year": { "type": [ "integer", "null" ] }, "title": { "type": "string" }, "imdb_link": { "type": "string" }, "categories": { "type": "array", "items": { "type": "object", "required": [ "category", "severity", "none_votes", "mild_votes", "moderate_votes", "severe_votes", "example_descriptions", "imdb_link" ], "properties": { "category": { "type": "string" }, "severity": { "type": [ "string", "null" ] }, "imdb_link": { "type": "string" }, "mild_votes": { "type": "integer" }, "none_votes": { "type": "integer" }, "severe_votes": { "type": "integer" }, "moderate_votes": { "type": "integer" }, "example_descriptions": { "type": "array", "items": { "type": "string" } } } } }, "age_certifications": { "type": "array", "items": { "type": "object", "required": [ "country", "rating", "notes" ], "properties": { "notes": { "type": [ "string", "null" ] }, "rating": { "type": "string" }, "country": { "type": "string" } } } } } } ``` ## See more - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null. - [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles. - [IMDb API: Get film person](https://fous.com/methods/imdb.com/get-person.md): Finds a film person on IMDb by name, IMDb person link or person ID and returns their biography, awards summary, known-for titles and filmography (without self-appearances, archive footage and thanks). - [Common Sense Media API: Get an age rating](https://fous.com/methods/commonsensemedia.org/get-age-rating.md): Finds the Common Sense Media review of a movie, TV show, game, book, app or podcast by title (optionally type and year) and returns its age rating, star rating, verdict and parents' guide. - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country. - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series. - [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings). - [Rotten Tomatoes API: Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md): Reads the newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show it combines reviews from its seasons. - [All IMDb methods](https://fous.com/methods/imdb.com.md)