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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Name, required
name The person's name, IMDb person link, or person ID, for example Cillian Murphy.
John Williams
- Max Credits optional
max_credits Maximum number of credits to return, for example 50.
200
Whole number from 1 to 200. Default
50.
Input as JSON
{ "name": "John Williams", "max_credits": 200}Output
{ "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" ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "imdb.com/get_person" , "input": { "name": "John Williams", "max_credits": 200 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "imdb.com/get_person" , "input": { "name": "John Williams", "max_credits": 200 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run imdb.com/get_person# with {"name":"John Williams","max_credits":200}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
imdb.com/get_person- 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
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method imdb.com/get_person with the inputs above.
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
See more
All IMDb methodsGets 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.com/get_movie_or_showLists 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.com/list_top_chartsGets 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.
imdb.com/get_parents_guideFinds 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.
themoviedb.org/get_movieLooks 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.
orcid.org/get_researcherGets 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.
wikiquote.org/get_quotes_by_personGets 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).
netflix.com/get_movie_or_showLists 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.
letterboxd.com/list_popular_films