# IMDb API: Get film person > 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). Unofficial. Not affiliated with or endorsed by IMDb. - Page: https://fous.com/methods/imdb.com/get-person - Method: `imdb.com/get_person`, version 1 - Website: imdb.com - Returns: name, professions, known-for titles, birth and death dates, birthplace, short biography, awards summary, photo, IMDb link, filmography with year, role, type and rating - 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 | |---|---|---|---|---| | `name` | string | yes | `"John Williams"` | The person's name, IMDb person link, or person ID, for example Cillian Murphy. | | `max_credits` | integer | no | `200` | Maximum number of credits to return, for example 50. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "name": "John Williams", "max_credits": 200 } ``` Its output: ```json { "name": "John Williams", "imdb_link": "https://www.imdb.com/name/nm0002354/", "person_id": "nm0002354", "birth_date": "1932-02-08", "birthplace": "Floral Park, Long Island, New York City, USA", "death_date": null, "photo_link": "https://m.media-amazon.com/images/M/MV5BMjY5MTgzMTQ1NF5BMl5BanBnXkFtZTYwNDg3OTcz._V1_.jpg", "filmography": [ { "type": "movie", "year": 2026, "title": "Supergirl", "title_id": "tt8814476", "imdb_link": "https://www.imdb.com/title/tt8814476/", "imdb_rating": 5.8, "role_or_job": "writer: \"Original Superman Theme\"" }, { "type": "series", "year": 2026, "title": "Star Wars: Maul - Shadow Lord", "title_id": "tt36594331", "imdb_link": "https://www.imdb.com/title/tt36594331/", "imdb_rating": 8.5, "role_or_job": "original star wars themes & score by" }, { "type": "movie", "year": 2026, "title": "Project Hail Mary", "title_id": "tt12042730", "imdb_link": "https://www.imdb.com/title/tt12042730/", "imdb_rating": 8.2, "role_or_job": "writer: \"Theme from Close Encounters of the Third Kind\"" } ], "awards_summary": "5 Oscar wins; 49 Oscar nominations; 218 total wins; 394 other nominations", "short_biography": "As one of the best known, awarded, and financially successful composers in US history, John Williams is as easy to recall as John Philip Sousa, Aaron Copland or Leonard Bernstein, illustrating why he is \"America's composer\" time and again.", "known_for_titles": [ "Star Wars: Episode IV - A New Hope", "Superman", "War of the Worlds" ], "main_professions": [ "Music Department", "Composer", "Actor" ] } ``` ## 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_person","input":{"name":"John Williams","max_credits":200}}' ``` 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 - Pull up Greta Gerwig's filmography and tell me what she's best known for - Who is nm0000138? I need their birth date, birthplace and a short bio - Get the awards summary and top 20 credits for Denis Villeneuve from IMDb - I want the full list of movies and shows Florence Pugh has acted in, with ratings — up to 100 credits - Look up https://www.imdb.com/name/nm0634240/ on IMDb and give me their professions, known-for titles and photo ## Input schema ```json { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "minLength": 1, "description": "The person's name, IMDb person link, or person ID, for example Cillian Murphy." }, "max_credits": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Maximum number of credits to return, for example 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "main_professions", "known_for_titles", "birth_date", "birthplace", "death_date", "short_biography", "awards_summary", "photo_link", "imdb_link", "person_id", "filmography" ], "properties": { "name": { "type": "string" }, "imdb_link": { "type": "string" }, "person_id": { "type": "string" }, "birth_date": { "type": [ "string", "null" ], "format": "date" }, "birthplace": { "type": [ "string", "null" ] }, "death_date": { "type": [ "string", "null" ], "format": "date" }, "photo_link": { "type": [ "string", "null" ] }, "filmography": { "type": "array", "items": { "type": "object", "required": [ "title", "year", "role_or_job", "type", "imdb_rating", "imdb_link", "title_id" ], "properties": { "type": { "enum": [ "movie", "series" ], "type": "string" }, "year": { "type": [ "integer", "null" ] }, "title": { "type": [ "string", "null" ] }, "title_id": { "type": "string" }, "imdb_link": { "type": "string" }, "imdb_rating": { "type": [ "number", "null" ] }, "role_or_job": { "type": "string" } } } }, "awards_summary": { "type": [ "string", "null" ] }, "short_biography": { "type": [ "string", "null" ] }, "known_for_titles": { "type": "array", "items": { "type": "string" } }, "main_professions": { "type": "array", "items": { "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 IMDb Parents Guide](https://fous.com/methods/imdb.com/get-parents-guide.md): 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. - [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. - [ORCID API: Get researcher profile](https://fous.com/methods/orcid.org/get-researcher.md): Looks up a researcher's public ORCID profile by name or ORCID iD, with employment, education, funding and up to 100 works. An institution helps tell namesakes apart; private entries are left out. - [Wikiquote API: Get quotes by person](https://fous.com/methods/wikiquote.org/get-quotes-by-person.md): Gets sourced, disputed and misattributed quotations for a person from their English Wikiquote page. Sourced quotes are included only when a citation or identified work appears on the page; Wikiquote attribution is not independent verification. - [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). - [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films. - [All IMDb methods](https://fous.com/methods/imdb.com.md)