--- type: "firecrawl-provider" description: "The Movie Database (themoviedb.org) from the public website, no API key and no login: title search with TMDB ids, movie and TV show details (overview, release dates, genres, user score, top-billed cast, keywords, facts), full cast and crew, streaming / rent / buy availability per country (JustWatch-sourced offers as the TMDB watch page shows them), per-country theatrical and digital release dates with certifications, people (biography, personal info, filmography) and TV season episode lists." use_when: "The Movie Database (themoviedb.org) from the public website, no API key and no login: title search with TMDB ids, movie and TV show details (overview, release dates, genres, user score, top-billed cast, keywords, facts), full cast and crew, streaming / rent / buy availability per country (JustWatch-sourced offers as the TMDB watch page shows them), per-country theatrical and digital release dates with certifications, people (biography, personal info, filmography) and TV season episode lists." categories: "Entertainment" capabilities: 7 credits_per_call: 5 --- # TMDB (The Movie Database) on Firecrawl Alexandria The Movie Database (themoviedb.org) from the public website, no API key and no login: title search with TMDB ids, movie and TV show details (overview, release dates, genres, user score, top-billed cast, keywords, facts), full cast and crew, streaming / rent / buy availability per country (JustWatch-sourced offers as the TMDB watch page shows them), per-country theatrical and digital release dates with certifications, people (biography, personal info, filmography) and TV season episode lists. - Categories: Entertainment - Category index: [Entertainment category](https://firecrawl.dev/alexandria/agents/categories/entertainment) - Provider key: `themoviedb-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/themoviedb-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/openapi.json) ## Capabilities - [Get credits](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_credits): The full cast and crew of a movie or TV show from its TMDB cast page: every cast member with character (and episode count for TV), every crew member with department and job(s), plus the counts the page shows. - [Get person](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_person): One person from their TMDB page: name, biography, known-for department, known credits count, gender, birthday and deathday, place of birth, also-known-as names, profile image, the known-for titles and the full filmography grouped by department with year, title, media type, character or job and TV episode count. - [Get release dates](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_release_dates): A movie's release dates by country from its TMDB releases page: ISO date, certification, release type (Premiere, Theatrical, Theatrical (limited), Digital, Physical, TV), language and note for every row, grouped as the page groups them. - [Get season](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_season): One season of a TV show from its TMDB season page: season name and year plus every episode with number, name, air date, runtime, user score percentage and overview. - [Get title](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_title): One movie or TV show from its TMDB page: title, original title, year, release / first and last air dates, tagline, overview, status, genres, certification, runtime, user score (percent and 0-10 average with vote count), poster and backdrop, homepage and JustWatch links, keywords, top-billed cast, featured crew (directors, writers, creators), networks and episode count for TV, budget and revenue for movies, and the page's streaming summary (e.g. 'Now Streaming on Netflix'). Addressed by media_type + tmdb_id or by a pasted themoviedb.org URL. - [Get watch providers](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_watch_providers): Where a movie or TV show can be watched in one country, as TMDB's JustWatch-powered watch panel lists it: stream, free, ads, rent and buy offers with provider name and JustWatch provider id, presentation quality (SD/HD/4K), price and currency where the panel shows one, the JustWatch click-out link and the JustWatch title page. A title with no offers in that country returns an empty list with the panel's own sentence. - [Search](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/search): Search TMDB for movies, TV shows and people by name through the site's suggest endpoint (one page of up to about 10 hits, ranked as the site ranks them). Each hit carries the TMDB id and media type needed by the other functions, the title, year, overview, poster, vote average and count. People carry their known-for department and up to three known-for titles. An unknown name returns an empty list. ## 1. Choose this provider when The Movie Database (themoviedb.org) from the public website, no API key and no login: title search with TMDB ids, movie and TV show details (overview, release dates, genres, user score, top-billed cast, keywords, facts), full cast and crew, streaming / rent / buy availability per country (JustWatch-sourced offers as the TMDB watch page shows them), per-country theatrical and digital release dates with certifications, people (biography, personal info, filmography) and TV season episode lists. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "themoviedb-org", "capability": "films/get_credits", "options": { "media_type": "movie", "tmdb_id": 220 } } ``` ## 3. Add provider options Use only the options needed for the task: - `media_type` (string): media_type Example: `movie` - `tmdb_id` (number): tmdb_id Example: `10` - `url` (string): A themoviedb.org movie or TV URL; alternative to media_type + tmdb_id. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "themoviedb-org", capability: "films/get_credits", options: { media_type: "movie", tmdb_id: 220, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "themoviedb-org", "capability": "films/get_credits", "options": { "media_type": "movie", "tmdb_id": 220 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "themoviedb-org", "capability": "films/get_credits", "options": { "media_type": "movie", "tmdb_id": 220 } } }' ``` ### CLI ```sh firecrawl scrape 'themoviedb-org/films/get_credits' \ --options '{"media_type":"movie","tmdb_id":220}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "themoviedb-org", "capability": "films/get_credits", "options": { "media_type": "movie", "tmdb_id": 220 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "themoviedb-org", "capability": "films/get_credits", "options": { "media_type": "movie", "tmdb_id": 220 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "cast": [ { "character": "Cal Trask", "name": "James Dean", "order": 0, "person_id": 2749, "url": "https://www.themoviedb.org/person/2749-james-dean" }, { "character": "Abra Bacon", "name": "Julie Harris", "order": 1, "person_id": 2750, "url": "https://www.themoviedb.org/person/2750-julie-harris" }, { "character": "Adam Trask", "name": "Raymond Massey", "order": 2, "person_id": 2669, "url": "https://www.themoviedb.org/person/2669-raymond-massey" }, { "character": "Aron Trask", "name": "Richard Davalos", "order": 3, "person_id": 2751, "url": "https://www.themoviedb.org/person/2751-richard-davalos" }, { "character": "Kate Trask", "name": "Jo Van Fleet", "order": 4, "person_id": 2752, "url": "https://www.themoviedb.org/person/2752-jo-van-fleet" }, { "character": "Sam the Sheriff", "name": "Burl Ives", "order": 5, "person_id": 2753, "url": "https://www.themoviedb.org/person/2753-burl-ives" }, { "character": "Will Hamilton", "name": "Albert Dekker", "order": 6, "person_id": 2755, "url": "https://www.themoviedb.org/person/2755-albert-dekker" }, { "character": "Anne", "name": "Lois Smith", "order": 7, "person_id": 2207, "url": "https://www.themoviedb.org/person/2207-lois-smith" }, { "character": "Gustav Albrecht", "name": "Harold Gordon", "order": 8, "person_id": 2756, "url": "https://www.themoviedb.org/person/2756-harold-gordon" }, { "character": "Rantani", "name": "Nick Dennis", "order": 9, "person_id": 2757, "url": "https://www.themoviedb.org/person/2757-nick-dennis" }, { "character": "Townsman at Carnival (uncredited)", "name": "Abdullah Abbas", "order": 10, "person_id": 1406724, "url": "https://www.themoviedb.org/person/1406724-abdullah-abbas" }, { "character": "Townsman (uncredited)", "name": "John Alban", "order": 11, "person_id": 1466128, "url": "https://www.themoviedb.org/person/1466128-john-alban" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Rose Allen", "order": 12, "person_id": 3853559, "url": "https://www.themoviedb.org/person/3853559-rose-allen" }, { "character": "Townsman (uncredited)", "name": "Frank Baker", "order": 13, "person_id": 27164, "url": "https://www.themoviedb.org/person/27164-frank-baker" }, { "character": "Nurse (uncredited)", "name": "Barbara Baxley", "order": 14, "person_id": 30610, "url": "https://www.themoviedb.org/person/30610-barbara-baxley" }, { "character": "Coalman at Lettuce Field (uncredited)", "name": "John Beradino", "order": 15, "person_id": 133738, "url": "https://www.themoviedb.org/person/133738-john-beradino" }, { "character": "Townsman at Carnival (uncredited)", "name": "Joe Brooks", "order": 16, "person_id": 1221260, "url": "https://www.themoviedb.org/person/1221260-joe-brooks" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Nora Bush", "order": 17, "person_id": 1551021, "url": "https://www.themoviedb.org/person/1551021-nora-bush" }, { "character": "Joe (uncredited)", "name": "Timothy Carey", "order": 18, "person_id": 2758, "url": "https://www.themoviedb.org/person/2758-timothy-carey" }, { "character": "Charlie (Townsman at Carnival) (uncredited)", "name": "Jack Carr", "order": 19, "person_id": 120215, "url": "https://www.themoviedb.org/person/120215-jack-carr" }, { "character": "Townsman at Carnival (uncredited)", "name": "Wheaton Chambers", "order": 20, "person_id": 32221, "url": "https://www.themoviedb.org/person/32221-wheaton-chambers" }, { "character": "Roy Turner (Automobile Mechanic) (uncredited)", "name": "Lonny Chapman", "order": 21, "person_id": 95598, "url": "https://www.themoviedb.org/person/95598-lonny-chapman" }, { "character": "Draft Board Member (uncredited)", "name": "Edward Clark", "order": 22, "person_id": 43826, "url": "https://www.themoviedb.org/person/43826-edward-clark" }, { "character": "Bouncer (uncredited)", "name": "Harry Cording", "order": 23, "person_id": 98052, "url": "https://www.themoviedb.org/person/98052-harry-cording" }, { "character": "Townsman at Carnival (uncredited)", "name": "Roger Creed", "order": 24, "person_id": 166335, "url": "https://www.themoviedb.org/person/166335-roger-creed" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Bryn Davis", "order": 25, "person_id": 2252297, "url": "https://www.themoviedb.org/person/2252297-bryn-davis" }, { "character": "Workman (uncredited)", "name": "Ray Dawe", "order": 26, "person_id": 1543578, "url": "https://www.themoviedb.org/person/1543578-ray-dawe" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Anna Dewey", "order": 27, "person_id": 3853613, "url": "https://www.themoviedb.org/person/3853613-anna-dewey" }, { "character": "City Official at Parade (uncredited)", "name": "Lester Dorr", "order": 28, "person_id": 121122, "url": "https://www.themoviedb.org/person/121122-lester-dorr" }, { "character": "Townsman at Carnival (uncredited)", "name": "Joe Dougherty", "order": 29, "person_id": 930167, "url": "https://www.themoviedb.org/person/930167-joe-dougherty" }, { "character": "Student (uncredited)", "name": "Darren Dublin", "order": 30, "person_id": 3442195, "url": "https://www.themoviedb.org/person/3442195-darren-dublin" }, { "character": "Townsman at Carnival (uncredited)", "name": "Franklyn Farnum", "order": 31, "person_id": 975597, "url": "https://www.themoviedb.org/person/975597-franklyn-farnum" }, { "character": "Townsman at Carnival (uncredited)", "name": "Al Ferguson", "order": 32, "person_id": 1090894, "url": "https://www.themoviedb.org/person/1090894-al-ferguson" }, { "character": "Student (uncredited)", "name": "Cliff Fields", "order": 33, "person_id": 1170486, "url": "https://www.themoviedb.org/person/1170486-cliff-fields" }, { "character": "Townsman at Carnival (uncredited)", "name": "Lloyd Ford", "order": 34, "person_id": 2091325, "url": "https://www.themoviedb.org/person/2091325-lloyd-ford" }, { "character": "Man at Boxcar (uncredited)", "name": "Robert Foulk", "order": 35, "person_id": 2784, "url": "https://www.themoviedb.org/person/2784-robert-foulk" }, { "character": "Townsman (uncredited)", "name": "Curt Furberg", "order": 36, "person_id": 2759981, "url": "https://www.themoviedb.org/person/2759981-curt-furberg" }, { "character": "Townsman at Carnival (uncredited)", "name": "Robert Gardett", "order": 37, "person_id": 1389140, "url": "https://www.themoviedb.org/person/1389140-robert-gardett" }, { "character": "Dr. Edwards (uncredited)", "name": "Richard Garrick", "order": 38, "person_id": 10542, "url": "https://www.themoviedb.org/person/10542-richard-garrick" }, { "character": "Townsman at Carnival (uncredited)", "name": "John George", "order": 39, "person_id": 97999, "url": "https://www.themoviedb.org/person/97999-john-george" }, { "character": "Townsman at Carnival (uncredited)", "name": "Leonard George", "order": 40, "person_id": 3696634, "url": "https://www.themoviedb.org/person/3696634-leonard-george" }, { "character": "Woman (uncredited)", "name": "Ruth Gillis", "order": 41, "person_id": 3852266, "url": "https://www.themoviedb.org/person/3852266-ruth-gillis" }, { "character": "City Official at Parade (uncredited)", "name": "John Halloran", "order": 42, "person_id": 88680, "url": "https://www.themoviedb.org/person/88680-john-halloran" }, { "character": "Official at Parade (uncredited)", "name": "Sam Harris", "order": 43, "person_id": 1216356, "url": "https://www.themoviedb.org/person/1216356-sam-harris" }, { "character": "Piscora's Son (uncredited)", "name": "Jonathan Haze", "order": 44, "person_id": 98452, "url": "https://www.themoviedb.org/person/98452-jonathan-haze" }, { "character": "English Officer (uncredited)", "name": "Ramsay Hill", "order": 45, "person_id": 1080053, "url": "https://www.themoviedb.org/person/1080053-ramsay-hill" }, { "character": "Shooting Gallery Concessionaire (uncredited)", "name": "Earle Hodgins", "order": 46, "person_id": 89938, "url": "https://www.themoviedb.org/person/89938-earle-hodgins" }, { "character": "Townsman (uncredited)", "name": "Tex Holden", "order": 47, "person_id": 1600506, "url": "https://www.themoviedb.org/person/1600506-tex-holden" }, { "character": "Student (uncredited)", "name": "Diane Howe", "order": 48, "person_id": 3853623, "url": "https://www.themoviedb.org/person/3853623-diane-howe" }, { "character": "City Official at Parade (uncredited)", "name": "Charles Anthony Hughes", "order": 49, "person_id": 138092, "url": "https://www.themoviedb.org/person/138092-charles-anthony-hughes" }, { "character": "Student (uncredited)", "name": "Gail Kobe", "order": 50, "person_id": 1234573, "url": "https://www.themoviedb.org/person/1234573-gail-kobe" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Effie Laird", "order": 51, "person_id": 103909, "url": "https://www.themoviedb.org/person/103909-effie-laird" }, { "character": "Townsman at Carnival (uncredited)", "name": "Billy Mahan", "order": 52, "person_id": 1277557, "url": "https://www.themoviedb.org/person/1277557-billy-mahan" }, { "character": "Townsman at Carnival (uncredited)", "name": "Mike Marienthal", "order": 53, "person_id": 3853628, "url": "https://www.themoviedb.org/person/3853628-mike-marienthal" }, { "character": "Student (uncredited)", "name": "Frank Mazzola", "order": 54, "person_id": 2783, "url": "https://www.themoviedb.org/person/2783-frank-mazzola" }, { "character": "Deputy Sheriff (uncredited)", "name": "Philo McCullough", "order": 55, "person_id": 1173173, "url": "https://www.themoviedb.org/person/1173173-philo-mccullough" }, { "character": "Soldier (uncredited)", "name": "Edward McNally", "order": 56, "person_id": 1234847, "url": "https://www.themoviedb.org/person/1234847-edward-mcnally" }, { "character": "Student (uncredited)", "name": "Ken Miller", "order": 57, "person_id": 39925, "url": "https://www.themoviedb.org/person/39925-ken-miller" }, { "character": "Bartender (uncredited)", "name": "Tex Mooney", "order": 58, "person_id": 2357810, "url": "https://www.themoviedb.org/person/2357810-tex-mooney" }, { "character": "Soldier on Train (uncredited)", "name": "Ralph Moratz", "order": 59, "person_id": 1551605, "url": "https://www.themoviedb.org/person/1551605-ralph-moratz" }, { "character": "Student (uncredited)", "name": "Robert Morris", "order": 60, "person_id": 3251128, "url": "https://www.themoviedb.org/person/3251128-robert-morris" }, { "character": "Townsman at Carnival (uncredited)", "name": "Paul Nichols", "order": 61, "person_id": 2060494, "url": "https://www.themoviedb.org/person/2060494-paul-nichols" }, { "character": "Townsman (uncredited)", "name": "Artie Ortego", "order": 62, "person_id": 88980, "url": "https://www.themoviedb.org/person/88980-artie-ortego" }, { "character": "Lettuce Truck Worker (uncredited)", "name": "Gil Perkins", "order": 63, "person_id": 1214919, "url": "https://www.themoviedb.org/person/1214919-gil-perkins" }, { "character": "Coalman at Lettuce Fields / Man at Exercise Class (uncredited)", "name": "William Phillips", "order": 64, "person_id": 94337, "url": "https://www.themoviedb.org/person/94337-william-phillips" }, { "character": "Rose (Townswoman at Carnival) (uncredited)", "name": "Rose Plumer", "order": 65, "person_id": 954129, "url": "https://www.themoviedb.org/person/954129-rose-plumer" }, { "character": "Student (uncredited)", "name": "Patricia Prest", "order": 66, "person_id": 108273, "url": "https://www.themoviedb.org/person/108273-patricia-prest" }, { "character": "Prisoner (uncredited)", "name": "Julian Rivero", "order": 67, "person_id": 161702, "url": "https://www.themoviedb.org/person/161702-julian-rivero" }, { "character": "Student (uncredited)", "name": "Mickey Roth", "order": 68, "person_id": 1299741, "url": "https://www.themoviedb.org/person/1299741-mickey-roth" }, { "character": "Helper at Boxcar (uncredited)", "name": "Henry Rowland", "order": 69, "person_id": 45164, "url": "https://www.themoviedb.org/person/45164-henry-rowland" }, { "character": "Card Dealer (uncredited)", "name": "Loretta Rush", "order": 70, "person_id": 1656957, "url": "https://www.themoviedb.org/person/1656957-loretta-rush" }, { "character": "Townsman (uncredited)", "name": "Scott Seaton", "order": 71, "person_id": 1364421, "url": "https://www.themoviedb.org/person/1364421-scott-seaton" }, { "character": "Townsman (uncredited)", "name": "Sammy Shack", "order": 72, "person_id": 1549831, "url": "https://www.themoviedb.org/person/1549831-sammy-shack" }, { "character": "Milk Bottle Concessionaire at Carnival (uncredited)", "name": "Charles Sherlock", "order": 73, "person_id": 385470, "url": "https://www.themoviedb.org/person/385470-charles-sherlock" }, { "character": "Mr. Piscora (uncredited)", "name": "Mario Siletti", "order": 74, "person_id": 87369, "url": "https://www.themoviedb.org/person/87369-mario-siletti" }, { "character": "City Official at Parade (uncredited)", "name": "Hal Taggart", "order": 75, "person_id": 1432701, "url": "https://www.themoviedb.org/person/1432701-hal-taggart" }, { "character": "Madame (uncredited)", "name": "Bette Treadville", "order": 76, "person_id": 3853563, "url": "https://www.themoviedb.org/person/3853563-bette-treadville" }, { "character": "Townsman at Carnival (uncredited)", "name": "Sid Troy", "order": 77, "person_id": 1289627, "url": "https://www.themoviedb.org/person/1289627-sid-troy" }, { "character": "Townsman in Parade / Townsman at Carnival (uncredited)", "name": "Sailor Vincent", "order": 78, "person_id": 572525, "url": "https://www.themoviedb.org/person/572525-sailor-vincent" }, { "character": "Workman (uncredited)", "name": "Max Wagner", "order": 79, "person_id": 120178, "url": "https://www.themoviedb.org/person/120178-max-wagner" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Lillian West", "order": 80, "person_id": 85738, "url": "https://www.themoviedb.org/person/85738-lillian-west" }, { "character": "Townsman at Carnival (uncredited)", "name": "Chalky Williams", "order": 81, "person_id": 1511232, "url": "https://www.themoviedb.org/person/1511232-chalky-williams" } ], "cast_count": 82, "crew": [ { "department": "Art", "jobs": [ "Production Design" ], "name": "James Basevi", "person_id": 2763, "url": "https://www.themoviedb.org/person/2763-james-basevi" }, { "department": "Art", "jobs": [ "Production Design" ], "name": "Malcolm C. Bert", "person_id": 2764, "url": "https://www.themoviedb.org/person/2764-malcolm-c-bert" }, { "department": "Art", "jobs": [ "Set Decoration" ], "name": "George James Hopkins", "person_id": 4126, "url": "https://www.themoviedb.org/person/4126-george-james-hopkins" }, { "department": "Art", "jobs": [ "Set Decoration" ], "name": "William Wallace", "person_id": 1137341, "url": "https://www.themoviedb.org/person/1137341-william-wallace" }, { "department": "Camera", "jobs": [ "Camera Operator" ], "name": "Conrad Hall", "person_id": 8217, "url": "https://www.themoviedb.org/person/8217-conrad-hall" }, { "department": "Camera", "jobs": [ "Director of Photography" ], "name": "Ted D. McCord", "person_id": 2760, "url": "https://www.themoviedb.org/person/2760-ted-d-mccord" }, { "department": "Costume & Makeup", "jobs": [ "Costume Design" ], "name": "Anna Hill Johnstone", "person_id": 6851, "url": "https://www.themoviedb.org/person/6851-anna-hill-johnstone" }, { "department": "Costume & Makeup", "jobs": [ "Hairstylist" ], "name": "Tillie Starriett", "person_id": 1530890, "url": "https://www.themoviedb.org/person/1530890-tillie-starriett" }, { "department": "Costume & Makeup", "jobs": [ "Makeup Artist" ], "name": "Gordon Bau", "person_id": 4313, "url": "https://www.themoviedb.org/person/4313-gordon-bau" }, { "department": "Costume & Makeup", "jobs": [ "Makeup Artist" ], "name": "Robert Ewing", "person_id": 191436, "url": "https://www.themoviedb.org/person/191436-robert-ewing" }, { "department": "Crew", "jobs": [ "Additional Dialogue" ], "name": "Guy Thomajan", "person_id": 14266, "url": "https://www.themoviedb.org/person/14266-guy-thomajan" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Gil Perkins", "person_id": 1214919, "url": "https://www.themoviedb.org/person/1214919-gil-perkins" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Mushy Callahan", "person_id": 2762, "url": "https://www.themoviedb.org/person/2762-mushy-callahan" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Sailor Vincent", "person_id": 572525, "url": "https://www.themoviedb.org/person/572525-sailor-vincent" }, { "department": "Directing", "jobs": [ "Assistant Director" ], "name": "Don Alvarado", "person_id": 85426, "url": "https://www.themoviedb.org/person/85426-don-alvarado" }, { "department": "Directing", "jobs": [ "Assistant Director" ], "name": "Horace Hough", "person_id": 1312999, "url": "https://www.themoviedb.org/person/1312999-horace-hough" }, { "department": "Directing", "jobs": [ "Director" ], "name": "Elia Kazan", "person_id": 2746, "url": "https://www.themoviedb.org/person/2746-elia-kazan" }, { "department": "Directing", "jobs": [ "Script Supervisor" ], "name": "Irva Mae Ross", "person_id": 1639186, "url": "https://www.themoviedb.org/person/1639186-irva-mae-ross" }, { "department": "Editing", "jobs": [ "Editor" ], "name": "Owen Marks", "person_id": 2761, "url": "https://www.themoviedb.org/person/2761-owen-marks" }, { "department": "Lighting", "jobs": [ "Gaffer" ], "name": "Charles O'Bannon", "person_id": 2161510, "url": "https://www.themoviedb.org/person/2161510-charles-o-bannon" }, { "department": "Production", "jobs": [ "Casting" ], "name": "Harvey Clermont", "person_id": 55696, "url": "https://www.themoviedb.org/person/55696-harvey-clermont" }, { "department": "Production", "jobs": [ "Producer" ], "name": "Elia Kazan", "person_id": 2746, "url": "https://www.themoviedb.org/person/2746-elia-kazan" }, { "department": "Production", "jobs": [ "Unit Manager" ], "name": "Don Alvarado", "person_id": 85426, "url": "https://www.themoviedb.org/person/85426-don-alvarado" }, { "department": "Sound", "jobs": [ "Orchestrator" ], "name": "Maurice De Packh", "person_id": 1531943, "url": "https://www.themoviedb.org/person/1531943-maurice-de-packh" }, { "department": "Sound", "jobs": [ "Original Music Composer" ], "name": "Leonard Rosenman", "person_id": 2027, "url": "https://www.themoviedb.org/person/2027-leonard-rosenman" }, { "department": "Sound", "jobs": [ "Sound" ], "name": "Stanley Jones", "person_id": 2791, "url": "https://www.themoviedb.org/person/2791-stanley-jones" }, { "department": "Writing", "jobs": [ "Novel" ], "name": "John Steinbeck", "person_id": 2747, "url": "https://www.themoviedb.org/person/2747-john-steinbeck" }, { "department": "Writing", "jobs": [ "Screenplay" ], "name": "Paul Osborn", "person_id": 2748, "url": "https://www.themoviedb.org/person/2748-paul-osborn" } ], "crew_count": 28, "media_type": "movie", "observed_at_ms": 1791923467085, "title": "East of Eden", "tmdb_id": 220, "url": "https://www.themoviedb.org/movie/220-east-of-eden/cast", "year": 1955 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get credits - Capability: `films/get_credits` - Description: The full cast and crew of a movie or TV show from its TMDB cast page: every cast member with character (and episode count for TV), every crew member with department and job(s), plus the counts the page shows. - Instructions: Who is in a film or show and who made it, beyond the top-billed strip get_title returns. - Cost: 5 credits per call - Capability file: [Get credits](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_credits) Accepted options: - `media_type` (string): media_type Example: `movie` - `tmdb_id` (number): tmdb_id Example: `10` - `url` (string): A themoviedb.org movie or TV URL; alternative to media_type + tmdb_id. Example: `` Response schema example: ```json { "cast": [ { "character": "Cal Trask", "name": "James Dean", "order": 0, "person_id": 2749, "url": "https://www.themoviedb.org/person/2749-james-dean" }, { "character": "Abra Bacon", "name": "Julie Harris", "order": 1, "person_id": 2750, "url": "https://www.themoviedb.org/person/2750-julie-harris" }, { "character": "Adam Trask", "name": "Raymond Massey", "order": 2, "person_id": 2669, "url": "https://www.themoviedb.org/person/2669-raymond-massey" }, { "character": "Aron Trask", "name": "Richard Davalos", "order": 3, "person_id": 2751, "url": "https://www.themoviedb.org/person/2751-richard-davalos" }, { "character": "Kate Trask", "name": "Jo Van Fleet", "order": 4, "person_id": 2752, "url": "https://www.themoviedb.org/person/2752-jo-van-fleet" }, { "character": "Sam the Sheriff", "name": "Burl Ives", "order": 5, "person_id": 2753, "url": "https://www.themoviedb.org/person/2753-burl-ives" }, { "character": "Will Hamilton", "name": "Albert Dekker", "order": 6, "person_id": 2755, "url": "https://www.themoviedb.org/person/2755-albert-dekker" }, { "character": "Anne", "name": "Lois Smith", "order": 7, "person_id": 2207, "url": "https://www.themoviedb.org/person/2207-lois-smith" }, { "character": "Gustav Albrecht", "name": "Harold Gordon", "order": 8, "person_id": 2756, "url": "https://www.themoviedb.org/person/2756-harold-gordon" }, { "character": "Rantani", "name": "Nick Dennis", "order": 9, "person_id": 2757, "url": "https://www.themoviedb.org/person/2757-nick-dennis" }, { "character": "Townsman at Carnival (uncredited)", "name": "Abdullah Abbas", "order": 10, "person_id": 1406724, "url": "https://www.themoviedb.org/person/1406724-abdullah-abbas" }, { "character": "Townsman (uncredited)", "name": "John Alban", "order": 11, "person_id": 1466128, "url": "https://www.themoviedb.org/person/1466128-john-alban" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Rose Allen", "order": 12, "person_id": 3853559, "url": "https://www.themoviedb.org/person/3853559-rose-allen" }, { "character": "Townsman (uncredited)", "name": "Frank Baker", "order": 13, "person_id": 27164, "url": "https://www.themoviedb.org/person/27164-frank-baker" }, { "character": "Nurse (uncredited)", "name": "Barbara Baxley", "order": 14, "person_id": 30610, "url": "https://www.themoviedb.org/person/30610-barbara-baxley" }, { "character": "Coalman at Lettuce Field (uncredited)", "name": "John Beradino", "order": 15, "person_id": 133738, "url": "https://www.themoviedb.org/person/133738-john-beradino" }, { "character": "Townsman at Carnival (uncredited)", "name": "Joe Brooks", "order": 16, "person_id": 1221260, "url": "https://www.themoviedb.org/person/1221260-joe-brooks" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Nora Bush", "order": 17, "person_id": 1551021, "url": "https://www.themoviedb.org/person/1551021-nora-bush" }, { "character": "Joe (uncredited)", "name": "Timothy Carey", "order": 18, "person_id": 2758, "url": "https://www.themoviedb.org/person/2758-timothy-carey" }, { "character": "Charlie (Townsman at Carnival) (uncredited)", "name": "Jack Carr", "order": 19, "person_id": 120215, "url": "https://www.themoviedb.org/person/120215-jack-carr" }, { "character": "Townsman at Carnival (uncredited)", "name": "Wheaton Chambers", "order": 20, "person_id": 32221, "url": "https://www.themoviedb.org/person/32221-wheaton-chambers" }, { "character": "Roy Turner (Automobile Mechanic) (uncredited)", "name": "Lonny Chapman", "order": 21, "person_id": 95598, "url": "https://www.themoviedb.org/person/95598-lonny-chapman" }, { "character": "Draft Board Member (uncredited)", "name": "Edward Clark", "order": 22, "person_id": 43826, "url": "https://www.themoviedb.org/person/43826-edward-clark" }, { "character": "Bouncer (uncredited)", "name": "Harry Cording", "order": 23, "person_id": 98052, "url": "https://www.themoviedb.org/person/98052-harry-cording" }, { "character": "Townsman at Carnival (uncredited)", "name": "Roger Creed", "order": 24, "person_id": 166335, "url": "https://www.themoviedb.org/person/166335-roger-creed" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Bryn Davis", "order": 25, "person_id": 2252297, "url": "https://www.themoviedb.org/person/2252297-bryn-davis" }, { "character": "Workman (uncredited)", "name": "Ray Dawe", "order": 26, "person_id": 1543578, "url": "https://www.themoviedb.org/person/1543578-ray-dawe" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Anna Dewey", "order": 27, "person_id": 3853613, "url": "https://www.themoviedb.org/person/3853613-anna-dewey" }, { "character": "City Official at Parade (uncredited)", "name": "Lester Dorr", "order": 28, "person_id": 121122, "url": "https://www.themoviedb.org/person/121122-lester-dorr" }, { "character": "Townsman at Carnival (uncredited)", "name": "Joe Dougherty", "order": 29, "person_id": 930167, "url": "https://www.themoviedb.org/person/930167-joe-dougherty" }, { "character": "Student (uncredited)", "name": "Darren Dublin", "order": 30, "person_id": 3442195, "url": "https://www.themoviedb.org/person/3442195-darren-dublin" }, { "character": "Townsman at Carnival (uncredited)", "name": "Franklyn Farnum", "order": 31, "person_id": 975597, "url": "https://www.themoviedb.org/person/975597-franklyn-farnum" }, { "character": "Townsman at Carnival (uncredited)", "name": "Al Ferguson", "order": 32, "person_id": 1090894, "url": "https://www.themoviedb.org/person/1090894-al-ferguson" }, { "character": "Student (uncredited)", "name": "Cliff Fields", "order": 33, "person_id": 1170486, "url": "https://www.themoviedb.org/person/1170486-cliff-fields" }, { "character": "Townsman at Carnival (uncredited)", "name": "Lloyd Ford", "order": 34, "person_id": 2091325, "url": "https://www.themoviedb.org/person/2091325-lloyd-ford" }, { "character": "Man at Boxcar (uncredited)", "name": "Robert Foulk", "order": 35, "person_id": 2784, "url": "https://www.themoviedb.org/person/2784-robert-foulk" }, { "character": "Townsman (uncredited)", "name": "Curt Furberg", "order": 36, "person_id": 2759981, "url": "https://www.themoviedb.org/person/2759981-curt-furberg" }, { "character": "Townsman at Carnival (uncredited)", "name": "Robert Gardett", "order": 37, "person_id": 1389140, "url": "https://www.themoviedb.org/person/1389140-robert-gardett" }, { "character": "Dr. Edwards (uncredited)", "name": "Richard Garrick", "order": 38, "person_id": 10542, "url": "https://www.themoviedb.org/person/10542-richard-garrick" }, { "character": "Townsman at Carnival (uncredited)", "name": "John George", "order": 39, "person_id": 97999, "url": "https://www.themoviedb.org/person/97999-john-george" }, { "character": "Townsman at Carnival (uncredited)", "name": "Leonard George", "order": 40, "person_id": 3696634, "url": "https://www.themoviedb.org/person/3696634-leonard-george" }, { "character": "Woman (uncredited)", "name": "Ruth Gillis", "order": 41, "person_id": 3852266, "url": "https://www.themoviedb.org/person/3852266-ruth-gillis" }, { "character": "City Official at Parade (uncredited)", "name": "John Halloran", "order": 42, "person_id": 88680, "url": "https://www.themoviedb.org/person/88680-john-halloran" }, { "character": "Official at Parade (uncredited)", "name": "Sam Harris", "order": 43, "person_id": 1216356, "url": "https://www.themoviedb.org/person/1216356-sam-harris" }, { "character": "Piscora's Son (uncredited)", "name": "Jonathan Haze", "order": 44, "person_id": 98452, "url": "https://www.themoviedb.org/person/98452-jonathan-haze" }, { "character": "English Officer (uncredited)", "name": "Ramsay Hill", "order": 45, "person_id": 1080053, "url": "https://www.themoviedb.org/person/1080053-ramsay-hill" }, { "character": "Shooting Gallery Concessionaire (uncredited)", "name": "Earle Hodgins", "order": 46, "person_id": 89938, "url": "https://www.themoviedb.org/person/89938-earle-hodgins" }, { "character": "Townsman (uncredited)", "name": "Tex Holden", "order": 47, "person_id": 1600506, "url": "https://www.themoviedb.org/person/1600506-tex-holden" }, { "character": "Student (uncredited)", "name": "Diane Howe", "order": 48, "person_id": 3853623, "url": "https://www.themoviedb.org/person/3853623-diane-howe" }, { "character": "City Official at Parade (uncredited)", "name": "Charles Anthony Hughes", "order": 49, "person_id": 138092, "url": "https://www.themoviedb.org/person/138092-charles-anthony-hughes" }, { "character": "Student (uncredited)", "name": "Gail Kobe", "order": 50, "person_id": 1234573, "url": "https://www.themoviedb.org/person/1234573-gail-kobe" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Effie Laird", "order": 51, "person_id": 103909, "url": "https://www.themoviedb.org/person/103909-effie-laird" }, { "character": "Townsman at Carnival (uncredited)", "name": "Billy Mahan", "order": 52, "person_id": 1277557, "url": "https://www.themoviedb.org/person/1277557-billy-mahan" }, { "character": "Townsman at Carnival (uncredited)", "name": "Mike Marienthal", "order": 53, "person_id": 3853628, "url": "https://www.themoviedb.org/person/3853628-mike-marienthal" }, { "character": "Student (uncredited)", "name": "Frank Mazzola", "order": 54, "person_id": 2783, "url": "https://www.themoviedb.org/person/2783-frank-mazzola" }, { "character": "Deputy Sheriff (uncredited)", "name": "Philo McCullough", "order": 55, "person_id": 1173173, "url": "https://www.themoviedb.org/person/1173173-philo-mccullough" }, { "character": "Soldier (uncredited)", "name": "Edward McNally", "order": 56, "person_id": 1234847, "url": "https://www.themoviedb.org/person/1234847-edward-mcnally" }, { "character": "Student (uncredited)", "name": "Ken Miller", "order": 57, "person_id": 39925, "url": "https://www.themoviedb.org/person/39925-ken-miller" }, { "character": "Bartender (uncredited)", "name": "Tex Mooney", "order": 58, "person_id": 2357810, "url": "https://www.themoviedb.org/person/2357810-tex-mooney" }, { "character": "Soldier on Train (uncredited)", "name": "Ralph Moratz", "order": 59, "person_id": 1551605, "url": "https://www.themoviedb.org/person/1551605-ralph-moratz" }, { "character": "Student (uncredited)", "name": "Robert Morris", "order": 60, "person_id": 3251128, "url": "https://www.themoviedb.org/person/3251128-robert-morris" }, { "character": "Townsman at Carnival (uncredited)", "name": "Paul Nichols", "order": 61, "person_id": 2060494, "url": "https://www.themoviedb.org/person/2060494-paul-nichols" }, { "character": "Townsman (uncredited)", "name": "Artie Ortego", "order": 62, "person_id": 88980, "url": "https://www.themoviedb.org/person/88980-artie-ortego" }, { "character": "Lettuce Truck Worker (uncredited)", "name": "Gil Perkins", "order": 63, "person_id": 1214919, "url": "https://www.themoviedb.org/person/1214919-gil-perkins" }, { "character": "Coalman at Lettuce Fields / Man at Exercise Class (uncredited)", "name": "William Phillips", "order": 64, "person_id": 94337, "url": "https://www.themoviedb.org/person/94337-william-phillips" }, { "character": "Rose (Townswoman at Carnival) (uncredited)", "name": "Rose Plumer", "order": 65, "person_id": 954129, "url": "https://www.themoviedb.org/person/954129-rose-plumer" }, { "character": "Student (uncredited)", "name": "Patricia Prest", "order": 66, "person_id": 108273, "url": "https://www.themoviedb.org/person/108273-patricia-prest" }, { "character": "Prisoner (uncredited)", "name": "Julian Rivero", "order": 67, "person_id": 161702, "url": "https://www.themoviedb.org/person/161702-julian-rivero" }, { "character": "Student (uncredited)", "name": "Mickey Roth", "order": 68, "person_id": 1299741, "url": "https://www.themoviedb.org/person/1299741-mickey-roth" }, { "character": "Helper at Boxcar (uncredited)", "name": "Henry Rowland", "order": 69, "person_id": 45164, "url": "https://www.themoviedb.org/person/45164-henry-rowland" }, { "character": "Card Dealer (uncredited)", "name": "Loretta Rush", "order": 70, "person_id": 1656957, "url": "https://www.themoviedb.org/person/1656957-loretta-rush" }, { "character": "Townsman (uncredited)", "name": "Scott Seaton", "order": 71, "person_id": 1364421, "url": "https://www.themoviedb.org/person/1364421-scott-seaton" }, { "character": "Townsman (uncredited)", "name": "Sammy Shack", "order": 72, "person_id": 1549831, "url": "https://www.themoviedb.org/person/1549831-sammy-shack" }, { "character": "Milk Bottle Concessionaire at Carnival (uncredited)", "name": "Charles Sherlock", "order": 73, "person_id": 385470, "url": "https://www.themoviedb.org/person/385470-charles-sherlock" }, { "character": "Mr. Piscora (uncredited)", "name": "Mario Siletti", "order": 74, "person_id": 87369, "url": "https://www.themoviedb.org/person/87369-mario-siletti" }, { "character": "City Official at Parade (uncredited)", "name": "Hal Taggart", "order": 75, "person_id": 1432701, "url": "https://www.themoviedb.org/person/1432701-hal-taggart" }, { "character": "Madame (uncredited)", "name": "Bette Treadville", "order": 76, "person_id": 3853563, "url": "https://www.themoviedb.org/person/3853563-bette-treadville" }, { "character": "Townsman at Carnival (uncredited)", "name": "Sid Troy", "order": 77, "person_id": 1289627, "url": "https://www.themoviedb.org/person/1289627-sid-troy" }, { "character": "Townsman in Parade / Townsman at Carnival (uncredited)", "name": "Sailor Vincent", "order": 78, "person_id": 572525, "url": "https://www.themoviedb.org/person/572525-sailor-vincent" }, { "character": "Workman (uncredited)", "name": "Max Wagner", "order": 79, "person_id": 120178, "url": "https://www.themoviedb.org/person/120178-max-wagner" }, { "character": "Townswoman at Carnival (uncredited)", "name": "Lillian West", "order": 80, "person_id": 85738, "url": "https://www.themoviedb.org/person/85738-lillian-west" }, { "character": "Townsman at Carnival (uncredited)", "name": "Chalky Williams", "order": 81, "person_id": 1511232, "url": "https://www.themoviedb.org/person/1511232-chalky-williams" } ], "cast_count": 82, "crew": [ { "department": "Art", "jobs": [ "Production Design" ], "name": "James Basevi", "person_id": 2763, "url": "https://www.themoviedb.org/person/2763-james-basevi" }, { "department": "Art", "jobs": [ "Production Design" ], "name": "Malcolm C. Bert", "person_id": 2764, "url": "https://www.themoviedb.org/person/2764-malcolm-c-bert" }, { "department": "Art", "jobs": [ "Set Decoration" ], "name": "George James Hopkins", "person_id": 4126, "url": "https://www.themoviedb.org/person/4126-george-james-hopkins" }, { "department": "Art", "jobs": [ "Set Decoration" ], "name": "William Wallace", "person_id": 1137341, "url": "https://www.themoviedb.org/person/1137341-william-wallace" }, { "department": "Camera", "jobs": [ "Camera Operator" ], "name": "Conrad Hall", "person_id": 8217, "url": "https://www.themoviedb.org/person/8217-conrad-hall" }, { "department": "Camera", "jobs": [ "Director of Photography" ], "name": "Ted D. McCord", "person_id": 2760, "url": "https://www.themoviedb.org/person/2760-ted-d-mccord" }, { "department": "Costume & Makeup", "jobs": [ "Costume Design" ], "name": "Anna Hill Johnstone", "person_id": 6851, "url": "https://www.themoviedb.org/person/6851-anna-hill-johnstone" }, { "department": "Costume & Makeup", "jobs": [ "Hairstylist" ], "name": "Tillie Starriett", "person_id": 1530890, "url": "https://www.themoviedb.org/person/1530890-tillie-starriett" }, { "department": "Costume & Makeup", "jobs": [ "Makeup Artist" ], "name": "Gordon Bau", "person_id": 4313, "url": "https://www.themoviedb.org/person/4313-gordon-bau" }, { "department": "Costume & Makeup", "jobs": [ "Makeup Artist" ], "name": "Robert Ewing", "person_id": 191436, "url": "https://www.themoviedb.org/person/191436-robert-ewing" }, { "department": "Crew", "jobs": [ "Additional Dialogue" ], "name": "Guy Thomajan", "person_id": 14266, "url": "https://www.themoviedb.org/person/14266-guy-thomajan" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Gil Perkins", "person_id": 1214919, "url": "https://www.themoviedb.org/person/1214919-gil-perkins" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Mushy Callahan", "person_id": 2762, "url": "https://www.themoviedb.org/person/2762-mushy-callahan" }, { "department": "Crew", "jobs": [ "Stunts" ], "name": "Sailor Vincent", "person_id": 572525, "url": "https://www.themoviedb.org/person/572525-sailor-vincent" }, { "department": "Directing", "jobs": [ "Assistant Director" ], "name": "Don Alvarado", "person_id": 85426, "url": "https://www.themoviedb.org/person/85426-don-alvarado" }, { "department": "Directing", "jobs": [ "Assistant Director" ], "name": "Horace Hough", "person_id": 1312999, "url": "https://www.themoviedb.org/person/1312999-horace-hough" }, { "department": "Directing", "jobs": [ "Director" ], "name": "Elia Kazan", "person_id": 2746, "url": "https://www.themoviedb.org/person/2746-elia-kazan" }, { "department": "Directing", "jobs": [ "Script Supervisor" ], "name": "Irva Mae Ross", "person_id": 1639186, "url": "https://www.themoviedb.org/person/1639186-irva-mae-ross" }, { "department": "Editing", "jobs": [ "Editor" ], "name": "Owen Marks", "person_id": 2761, "url": "https://www.themoviedb.org/person/2761-owen-marks" }, { "department": "Lighting", "jobs": [ "Gaffer" ], "name": "Charles O'Bannon", "person_id": 2161510, "url": "https://www.themoviedb.org/person/2161510-charles-o-bannon" }, { "department": "Production", "jobs": [ "Casting" ], "name": "Harvey Clermont", "person_id": 55696, "url": "https://www.themoviedb.org/person/55696-harvey-clermont" }, { "department": "Production", "jobs": [ "Producer" ], "name": "Elia Kazan", "person_id": 2746, "url": "https://www.themoviedb.org/person/2746-elia-kazan" }, { "department": "Production", "jobs": [ "Unit Manager" ], "name": "Don Alvarado", "person_id": 85426, "url": "https://www.themoviedb.org/person/85426-don-alvarado" }, { "department": "Sound", "jobs": [ "Orchestrator" ], "name": "Maurice De Packh", "person_id": 1531943, "url": "https://www.themoviedb.org/person/1531943-maurice-de-packh" }, { "department": "Sound", "jobs": [ "Original Music Composer" ], "name": "Leonard Rosenman", "person_id": 2027, "url": "https://www.themoviedb.org/person/2027-leonard-rosenman" }, { "department": "Sound", "jobs": [ "Sound" ], "name": "Stanley Jones", "person_id": 2791, "url": "https://www.themoviedb.org/person/2791-stanley-jones" }, { "department": "Writing", "jobs": [ "Novel" ], "name": "John Steinbeck", "person_id": 2747, "url": "https://www.themoviedb.org/person/2747-john-steinbeck" }, { "department": "Writing", "jobs": [ "Screenplay" ], "name": "Paul Osborn", "person_id": 2748, "url": "https://www.themoviedb.org/person/2748-paul-osborn" } ], "crew_count": 28, "media_type": "movie", "observed_at_ms": 1791923467085, "title": "East of Eden", "tmdb_id": 220, "url": "https://www.themoviedb.org/movie/220-east-of-eden/cast", "year": 1955 } ``` ### Get person - Capability: `films/get_person` - Description: One person from their TMDB page: name, biography, known-for department, known credits count, gender, birthday and deathday, place of birth, also-known-as names, profile image, the known-for titles and the full filmography grouped by department with year, title, media type, character or job and TV episode count. - Instructions: Who someone is and what they have been in or worked on. - Cost: 5 credits per call - Capability file: [Get person](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_person) Accepted options: - `person_id` (number): TMDB person id. Example: `10` - `url` (string): A themoviedb.org person URL; alternative to person_id. Example: `` Response schema example: ```json { "also_known_as": [ "Florence Rose C. M. Pugh", "Florence Rose Pugh", "Florence Rose Clara Madeleine Pugh", "Flossie Rose" ], "biography": "Florence Pugh (born 3 January 1996) is an English actress. Her accolades include a British Independent Film Award, in addition to nominations for an Academy Award and three BAFTA Awards.\n\nAfter making her acting debut in the drama film The Falling (2014), Pugh gained praise for starring in the independent drama Lady Macbeth (2016) and the miniseries The Little Drummer Girl (2018). Her international breakthrough came in 2019 with her portrayals of professional wrestler Paige in the sports film Fighting with My Family, a despondent American woman in the horror film Midsommar, and Amy March in the period drama Little Women. For the last of these, she was nominated for the Academy Award for Best Supporting Actress.\n\nPugh has played Yelena Belova in the Marvel Cinematic Universe, starring in the films Black Widow (2021), Thunderbolts* (2025), and Spider-Man: Brand New Day (2026), as well as the Disney+ miniseries Hawkeye (2021). In her highest-grossing releases, she voiced Goldilocks in Puss in Boots: The Last Wish (2022), and portrayed Jean Tatlock in Oppenheimer (2023) and Princess Irulan in Dune: Part Two (2024); she also continued to gain praise for her performances in dramas such as We Live in Time (2024).\n\nDescription above from the Wikipedia article Florence Pugh, licensed under CC-BY-SA, full list of contributors on Wikipedia.", "birthday": "1996-01-03", "credits": [ { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Cassandra / Judith", "title": "Cassandra at the Wedding", "tmdb_id": 1024778, "url": "https://www.themoviedb.org/movie/1024778-cassandra-at-the-wedding", "year": null }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": null, "title": "42.6 Years", "tmdb_id": 1084033, "url": "https://www.themoviedb.org/movie/1084033-42-6-years", "year": null }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Nora Seed", "title": "The Midnight Library", "tmdb_id": 1669945, "url": "https://www.themoviedb.org/movie/1669945-the-midnight-library", "year": null }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Molly", "title": "The Maid", "tmdb_id": 776864, "url": "https://www.themoviedb.org/movie/776864-the-maid", "year": null }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": null, "title": "The Pack", "tmdb_id": 1041577, "url": "https://www.themoviedb.org/movie/1041577-the-pack", "year": null }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Yelena Belova", "title": "Avengers: Secret Wars", "tmdb_id": 1003598, "url": "https://www.themoviedb.org/movie/1003598-avengers-secret-wars", "year": 2027 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Yelena Belova", "title": "Avengers: Doomsday", "tmdb_id": 1003596, "url": "https://www.themoviedb.org/movie/1003596-avengers-doomsday", "year": 2026 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Princess Irulan", "title": "Dune: Part Three", "tmdb_id": 1170608, "url": "https://www.themoviedb.org/movie/1170608-dune-part-three", "year": 2026 }, { "department": "Acting", "episode_count": 7, "media_type": "tv", "role": "Cathy Ames", "title": "East of Eden", "tmdb_id": 258165, "url": "https://www.themoviedb.org/tv/258165-east-of-eden", "year": 2026 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "The Graham Norton Show", "tmdb_id": 1220, "url": "https://www.themoviedb.org/tv/1220-the-graham-norton-show", "year": 2026 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "The Emmy Awards", "tmdb_id": 28464, "url": "https://www.themoviedb.org/tv/28464-the-emmy-awards", "year": 2026 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Yelena Belova / Black Widow", "title": "Spider-Man: Brand New Day", "tmdb_id": 969681, "url": "https://www.themoviedb.org/movie/969681-spider-man-brand-new-day", "year": 2026 }, { "department": "Acting", "episode_count": 2, "media_type": "tv", "role": "Yelena Belova (voice)", "title": "Marvel Zombies", "tmdb_id": 138505, "url": "https://www.themoviedb.org/tv/138505-marvel-zombies", "year": 2025 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Self", "title": "Together for Palestine", "tmdb_id": 1605005, "url": "https://www.themoviedb.org/movie/1605005-together-for-palestine", "year": 2025 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self - Guest", "title": "The Kelly Clarkson Show", "tmdb_id": 82873, "url": "https://www.themoviedb.org/tv/82873-the-kelly-clarkson-show", "year": 2025 }, { "department": "Acting", "episode_count": 2, "media_type": "tv", "role": "Self - Guest", "title": "LIVE with Kelly and Mark", "tmdb_id": 1900, "url": "https://www.themoviedb.org/tv/1900-live-with-kelly-and-mark", "year": 2025 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Yelena Belova", "title": "Thunderbolts*", "tmdb_id": 986056, "url": "https://www.themoviedb.org/movie/986056-thunderbolts", "year": 2025 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "The One Show", "tmdb_id": 1514, "url": "https://www.themoviedb.org/tv/1514-the-one-show", "year": 2025 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "No Taste Like Home with Antoni Porowski", "tmdb_id": 282756, "url": "https://www.themoviedb.org/tv/282756-no-taste-like-home-with-antoni-porowski", "year": 2025 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Celebrity Substitute", "tmdb_id": 282813, "url": "https://www.themoviedb.org/tv/282813-celebrity-substitute", "year": 2024 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self - Clue Presenter", "title": "Jeopardy!", "tmdb_id": 2912, "url": "https://www.themoviedb.org/tv/2912-jeopardy", "year": 2024 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Almut Brühl", "title": "We Live in Time", "tmdb_id": 1100099, "url": "https://www.themoviedb.org/movie/1100099-we-live-in-time", "year": 2024 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Princess Irulan", "title": "Dune: Part Two", "tmdb_id": 693134, "url": "https://www.themoviedb.org/movie/693134-dune-part-two", "year": 2024 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self - Presenter", "title": "Golden Globe Awards", "tmdb_id": 71494, "url": "https://www.themoviedb.org/tv/71494-golden-globe-awards", "year": 2024 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Jean Tatlock", "title": "Oppenheimer", "tmdb_id": 872585, "url": "https://www.themoviedb.org/movie/872585-oppenheimer", "year": 2023 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Self - Jean Tatlock", "title": "Inside Christopher Nolan's Oppenheimer", "tmdb_id": 1152711, "url": "https://www.themoviedb.org/movie/1152711-inside-christopher-nolan-s-oppenheimer", "year": 2023 }, { "department": "Acting", "episode_count": 4, "media_type": "tv", "role": "Sarah Crumbhorn (voice)", "title": "Human Resources", "tmdb_id": 94252, "url": "https://www.themoviedb.org/tv/94252-human-resources", "year": 2023 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Hot Ones", "tmdb_id": 72649, "url": "https://www.themoviedb.org/tv/72649-hot-ones", "year": 2023 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Allison", "title": "A Good Person", "tmdb_id": 800787, "url": "https://www.themoviedb.org/movie/800787-a-good-person", "year": 2023 }, { "department": "Acting", "episode_count": 2, "media_type": "tv", "role": "Self - Guest", "title": "The Tonight Show Starring Jimmy Fallon", "tmdb_id": 59941, "url": "https://www.themoviedb.org/tv/59941-the-tonight-show-starring-jimmy-fallon", "year": 2023 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Jimmy Kimmel Live!", "tmdb_id": 1489, "url": "https://www.themoviedb.org/tv/1489-jimmy-kimmel-live", "year": 2023 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Goldilocks (voice)", "title": "The Trident", "tmdb_id": 1088561, "url": "https://www.themoviedb.org/movie/1088561-the-trident", "year": 2023 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Goldilocks (voice)", "title": "Puss in Boots: The Last Wish", "tmdb_id": 315162, "url": "https://www.themoviedb.org/movie/315162-puss-in-boots-the-last-wish", "year": 2022 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Lib Wright", "title": "The Wonder", "tmdb_id": 823766, "url": "https://www.themoviedb.org/movie/823766-the-wonder", "year": 2022 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Alice", "title": "Don't Worry Darling", "tmdb_id": 619730, "url": "https://www.themoviedb.org/movie/619730-don-t-worry-darling", "year": 2022 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Running Wild with Bear Grylls: The Challenge", "tmdb_id": 204577, "url": "https://www.themoviedb.org/tv/204577-running-wild-with-bear-grylls-the-challenge", "year": 2022 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Self - Yelena", "title": "Marvel Studios Assembled: The Making of Hawkeye", "tmdb_id": 936643, "url": "https://www.themoviedb.org/movie/936643-marvel-studios-assembled-the-making-of-hawkeye", "year": 2022 }, { "department": "Acting", "episode_count": 3, "media_type": "tv", "role": "Yelena Belova", "title": "Hawkeye", "tmdb_id": 88329, "url": "https://www.themoviedb.org/tv/88329-hawkeye", "year": 2021 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Marvel Studios Assembled", "tmdb_id": 118924, "url": "https://www.themoviedb.org/tv/118924-marvel-studios-assembled", "year": 2021 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Self - Actress", "title": "Attack of the Hollywood Clichés!", "tmdb_id": 877657, "url": "https://www.themoviedb.org/movie/877657-attack-of-the-hollywood-cliches", "year": 2021 }, { "department": "Acting", "episode_count": 4, "media_type": "tv", "role": "Self - Guest", "title": "Late Night with Seth Meyers", "tmdb_id": 61818, "url": "https://www.themoviedb.org/tv/61818-late-night-with-seth-meyers", "year": 2021 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Yelena Belova", "title": "Black Widow", "tmdb_id": 497698, "url": "https://www.themoviedb.org/movie/497698-black-widow", "year": 2021 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Megan", "title": "Father of the Bride Part 3 (ish)", "tmdb_id": 746358, "url": "https://www.themoviedb.org/movie/746358-father-of-the-bride-part-3-ish", "year": 2020 }, { "department": "Acting", "episode_count": 3, "media_type": "tv", "role": "Self", "title": "The Oscars", "tmdb_id": 27023, "url": "https://www.themoviedb.org/tv/27023-the-oscars", "year": 2020 }, { "department": "Acting", "episode_count": 4, "media_type": "tv", "role": "Self - Guest", "title": "Jimmy Kimmel Live!", "tmdb_id": 1489, "url": "https://www.themoviedb.org/tv/1489-jimmy-kimmel-live", "year": 2020 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "Variety Studio: Actors on Actors", "tmdb_id": 105197, "url": "https://www.themoviedb.org/tv/105197-variety-studio-actors-on-actors", "year": 2020 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Amy March", "title": "Little Women", "tmdb_id": 331482, "url": "https://www.themoviedb.org/movie/331482-little-women", "year": 2019 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self - Guest", "title": "The Late Show with Stephen Colbert", "tmdb_id": 63770, "url": "https://www.themoviedb.org/tv/63770-the-late-show-with-stephen-colbert", "year": 2019 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Self", "title": "Let the Festivities Begin: Manifesting Midsommar", "tmdb_id": 1284571, "url": "https://www.themoviedb.org/movie/1284571-let-the-festivities-begin-manifesting-midsommar", "year": 2019 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Dani", "title": "Midsommar", "tmdb_id": 530385, "url": "https://www.themoviedb.org/movie/530385-midsommar", "year": 2019 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Lucille", "title": "In the Time It Takes to Get There", "tmdb_id": 592747, "url": "https://www.themoviedb.org/movie/592747-in-the-time-it-takes-to-get-there", "year": 2019 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Saraya 'Paige' Knight", "title": "Fighting with My Family", "tmdb_id": 445629, "url": "https://www.themoviedb.org/movie/445629-fighting-with-my-family", "year": 2019 }, { "department": "Acting", "episode_count": 1, "media_type": "tv", "role": "Self", "title": "WWE Friday Night SmackDown", "tmdb_id": 1549, "url": "https://www.themoviedb.org/tv/1549-wwe-friday-night-smackdown", "year": 2019 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Angela Sayers", "title": "Malevolent", "tmdb_id": 481375, "url": "https://www.themoviedb.org/movie/481375-malevolent", "year": 2018 }, { "department": "Acting", "episode_count": 6, "media_type": "tv", "role": "Charmian 'Charlie' Ross", "title": "The Little Drummer Girl", "tmdb_id": 76887, "url": "https://www.themoviedb.org/tv/76887-the-little-drummer-girl", "year": 2018 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Elizabeth Burgh", "title": "Outlaw King", "tmdb_id": 454227, "url": "https://www.themoviedb.org/movie/454227-outlaw-king", "year": 2018 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Cordelia", "title": "King Lear", "tmdb_id": 513427, "url": "https://www.themoviedb.org/movie/513427-king-lear", "year": 2018 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Actress #4", "title": "Leading Lady Parts", "tmdb_id": 539572, "url": "https://www.themoviedb.org/movie/539572-leading-lady-parts", "year": 2018 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Gwen", "title": "The Commuter", "tmdb_id": 399035, "url": "https://www.themoviedb.org/movie/399035-the-commuter", "year": 2018 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Katherine Lester", "title": "Lady Macbeth", "tmdb_id": 410117, "url": "https://www.themoviedb.org/movie/410117-lady-macbeth", "year": 2016 }, { "department": "Acting", "episode_count": 3, "media_type": "tv", "role": "Cara Thomas", "title": "Marcella", "tmdb_id": 66023, "url": "https://www.themoviedb.org/tv/66023-marcella", "year": 2016 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Eve", "title": "Paradise Lost?", "tmdb_id": 520372, "url": "https://www.themoviedb.org/movie/520372-paradise-lost", "year": 2015 }, { "department": "Acting", "episode_count": null, "media_type": "movie", "role": "Abbie Mortimer", "title": "The Falling", "tmdb_id": 294741, "url": "https://www.themoviedb.org/movie/294741-the-falling", "year": 2015 }, { "department": "Production", "episode_count": null, "media_type": "movie", "role": "Producer", "title": "Cassandra at the Wedding", "tmdb_id": 1024778, "url": "https://www.themoviedb.org/movie/1024778-cassandra-at-the-wedding", "year": null }, { "department": "Production", "episode_count": null, "media_type": "movie", "role": "Producer", "title": "The Midnight Library", "tmdb_id": 1669945, "url": "https://www.themoviedb.org/movie/1669945-the-midnight-library", "year": null }, { "department": "Production", "episode_count": null, "media_type": "movie", "role": "Producer", "title": "The Maid", "tmdb_id": 776864, "url": "https://www.themoviedb.org/movie/776864-the-maid", "year": null }, { "department": "Production", "episode_count": 7, "media_type": "tv", "role": "Executive Producer", "title": "East of Eden", "tmdb_id": 258165, "url": "https://www.themoviedb.org/tv/258165-east-of-eden", "year": 2026 }, { "department": "Production", "episode_count": null, "media_type": "movie", "role": "Producer", "title": "A Good Person", "tmdb_id": 800787, "url": "https://www.themoviedb.org/movie/800787-a-good-person", "year": 2023 }, { "department": "Sound", "episode_count": null, "media_type": "movie", "role": "Songs", "title": "A Good Person", "tmdb_id": 800787, "url": "https://www.themoviedb.org/movie/800787-a-good-person", "year": 2023 } ], "deathday": null, "gender": "Female", "homepage": null, "known_credits": 62, "known_for": [ { "media_type": "movie", "title": "Midsommar", "tmdb_id": 530385, "url": "https://www.themoviedb.org/movie/530385-midsommar" }, { "media_type": "movie", "title": "Black Widow", "tmdb_id": 497698, "url": "https://www.themoviedb.org/movie/497698-black-widow" }, { "media_type": "movie", "title": "Thunderbolts*", "tmdb_id": 986056, "url": "https://www.themoviedb.org/movie/986056-thunderbolts" }, { "media_type": "movie", "title": "Don't Worry Darling", "tmdb_id": 619730, "url": "https://www.themoviedb.org/movie/619730-don-t-worry-darling" }, { "media_type": "movie", "title": "Oppenheimer", "tmdb_id": 872585, "url": "https://www.themoviedb.org/movie/872585-oppenheimer" }, { "media_type": "movie", "title": "Little Women", "tmdb_id": 331482, "url": "https://www.themoviedb.org/movie/331482-little-women" }, { "media_type": "movie", "title": "Fighting with My Family", "tmdb_id": 445629, "url": "https://www.themoviedb.org/movie/445629-fighting-with-my-family" }, { "media_type": "movie", "title": "Puss in Boots: The Last Wish", "tmdb_id": 315162, "url": "https://www.themoviedb.org/movie/315162-puss-in-boots-the-last-wish" } ], "known_for_department": "Acting", "name": "Florence Pugh", "observed_at_ms": 1791923494514, "person_id": 1373737, "place_of_birth": "Oxford, Oxfordshire, England UK", "profile_url": "https://image.tmdb.org/t/p/w500/2URrZb95t3kY6pLroKny3Enmabp.jpg", "url": "https://www.themoviedb.org/person/1373737-florence-pugh" } ``` ### Get release dates - Capability: `films/get_release_dates` - Description: A movie's release dates by country from its TMDB releases page: ISO date, certification, release type (Premiere, Theatrical, Theatrical (limited), Digital, Physical, TV), language and note for every row, grouped as the page groups them. - Instructions: Is a film out yet, where and when it was or will be released, and with which rating. - Cost: 5 credits per call - Capability file: [Get release dates](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_release_dates) Accepted options: - `tmdb_id` (number): TMDB movie id. Example: `10` - `url` (string): A themoviedb.org movie URL; alternative to tmdb_id. Example: `` Response schema example: ```json { "media_type": "movie", "observed_at_ms": 1791923486171, "releases": [ { "certification": "R", "country": "United States", "country_code": "US", "date": "2026-09-29", "language": null, "note": "AMC Lincoln Square 13 (New York City, New York)", "type": "Premiere" }, { "certification": "R", "country": "United States", "country_code": "US", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "+13", "country": "Argentina", "country_code": "AR", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "MA 15+", "country": "Australia", "country_code": "AU", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Azerbaijan", "country_code": "AZ", "date": "2026-10-08", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Bahrain", "country_code": "BH", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "12", "country": "Belgium", "country_code": "BE", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16", "country": "Brazil", "country_code": "BR", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16", "country": "Brazil", "country_code": "BR", "date": "2026-10-27", "language": null, "note": null, "type": "Digital" }, { "certification": "D", "country": "Bulgaria", "country_code": "BG", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "14A", "country": "Canada", "country_code": "CA", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "14", "country": "Chile", "country_code": "CL", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Colombia", "country_code": "CO", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15+", "country": "Czech Republic", "country_code": "CZ", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Estonia", "country_code": "EE", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "K-12", "country": "Finland", "country_code": "FI", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical (limited)" }, { "certification": "K-12", "country": "Finland", "country_code": "FI", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "France", "country_code": "FR", "date": "2026-09-21", "language": null, "note": "Grand Rex Paris", "type": "Premiere" }, { "certification": "TP", "country": "France", "country_code": "FR", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": "12", "country": "Germany", "country_code": "DE", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "K15", "country": "Greece", "country_code": "GR", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Guatemala", "country_code": "GT", "date": "2026-10-01", "language": null, "note": "B15", "type": "Theatrical" }, { "certification": "III", "country": "Hong Kong SAR China", "country_code": "HK", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "A", "country": "India", "country_code": "IN", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "17+", "country": "Indonesia", "country_code": "ID", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15A", "country": "Ireland", "country_code": "IE", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "14", "country": "Israel", "country_code": "IL", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": "10+", "country": "Italy", "country_code": "IT", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Japan", "country_code": "JP", "date": "2026-10-29", "language": null, "note": "Tokyo International Film Festival", "type": "Premiere" }, { "certification": null, "country": "Kazakhstan", "country_code": "KZ", "date": "2026-10-08", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16+", "country": "Latvia", "country_code": "LV", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": "N-16", "country": "Lithuania", "country_code": "LT", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "D", "country": "Macau SAR China", "country_code": "MO", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "B-15", "country": "Mexico", "country_code": "MX", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "12", "country": "Netherlands", "country_code": "NL", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "R16", "country": "New Zealand", "country_code": "NZ", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Oman", "country_code": "OM", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Peru", "country_code": "PE", "date": "2026-10-01", "language": null, "note": "B14", "type": "Theatrical" }, { "certification": "R-16", "country": "Philippines", "country_code": "PH", "date": "2026-09-30", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Poland", "country_code": "PL", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Portugal", "country_code": "PT", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "R", "country": "Puerto Rico", "country_code": "PR", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Saudi Arabia", "country_code": "SA", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Serbia", "country_code": "RS", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "M18", "country": "Singapore", "country_code": "SG", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15", "country": "South Korea", "country_code": "KR", "date": "2026-10-22", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16", "country": "Spain", "country_code": "ES", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15", "country": "Sweden", "country_code": "SE", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "14", "country": "Switzerland", "country_code": "CH", "date": "2026-10-01", "language": "de", "note": null, "type": "Theatrical" }, { "certification": "15+", "country": "Taiwan", "country_code": "TW", "date": "2026-10-08", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15", "country": "Thailand", "country_code": "TH", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16+", "country": "Turkey", "country_code": "TR", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": "16+", "country": "Ukraine", "country_code": "UA", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "United Arab Emirates", "country_code": "AE", "date": "2026-10-01", "language": null, "note": null, "type": "Theatrical" }, { "certification": "15", "country": "United Kingdom", "country_code": "GB", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" }, { "certification": null, "country": "Vietnam", "country_code": "VN", "date": "2026-10-02", "language": null, "note": null, "type": "Theatrical" } ], "title": "Verity", "tmdb_id": 1283515, "total": 56, "url": "https://www.themoviedb.org/movie/1283515-verity/releases", "year": 2026 } ``` ### Get season - Capability: `films/get_season` - Description: One season of a TV show from its TMDB season page: season name and year plus every episode with number, name, air date, runtime, user score percentage and overview. - Instructions: Episode list and air dates of a season; is a new episode out yet. - Cost: 5 credits per call - Capability file: [Get season](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_season) Accepted options: - `season_number` (number, required): Season number as TMDB numbers it (0 = specials). Example: `10` - `tmdb_id` (number, required): TMDB TV show id. Example: `10` Response schema example: ```json { "episode_count": 7, "episodes": [ { "air_date": "2026-10-01", "episode_number": 1, "name": "Brothers", "overview": "Torn apart by a domineering father, brothers Adam and Charles Trask are forced into opposing paths to adulthood — one far away, one close to home.", "runtime_minutes": 51, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/1", "user_score_percent": 81 }, { "air_date": "2026-10-01", "episode_number": 2, "name": "Cathy", "overview": "Cathy revisits her dark past, as her presence in the brothers' home sows discord in the present.", "runtime_minutes": 61, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/2", "user_score_percent": 77 }, { "air_date": "2026-10-01", "episode_number": 3, "name": "In the Valley", "overview": "While Adam pursues his dream of a home and family in California, Cathy has her own ideas about the future.", "runtime_minutes": 58, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/3", "user_score_percent": 78 }, { "air_date": "2026-10-01", "episode_number": 4, "name": "Kate", "overview": "Cathy starts over with a new name, a new life and a ruthless plan to achieve financial independence.", "runtime_minutes": 60, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/4", "user_score_percent": 85 }, { "air_date": "2026-10-01", "episode_number": 5, "name": "Departure", "overview": "Ten years on, an encounter with Cathy shifts Adam's perspective, as he and Lee clash over telling the boys the truth about their mother.", "runtime_minutes": 57, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/5", "user_score_percent": 76 }, { "air_date": "2026-10-01", "episode_number": 6, "name": "The Great Try", "overview": "Adam embarks on a bold new business venture. An alienated Cal is drawn to his family's past, while Cathy's begins to catch up with her.", "runtime_minutes": 59, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/6", "user_score_percent": 80 }, { "air_date": "2026-10-01", "episode_number": 7, "name": "Timshel", "overview": "With World War I looming, the family wonders if the sins of the past can ever be erased — and whether a new generation is doomed to repeat them.", "runtime_minutes": 68, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1/episode/7", "user_score_percent": 83 } ], "name": "Limited Series", "observed_at_ms": 1791923503427, "season_number": 1, "tmdb_id": 258165, "url": "https://www.themoviedb.org/tv/258165-east-of-eden/season/1", "year": 2026 } ``` ### Get title - Capability: `films/get_title` - Description: One movie or TV show from its TMDB page: title, original title, year, release / first and last air dates, tagline, overview, status, genres, certification, runtime, user score (percent and 0-10 average with vote count), poster and backdrop, homepage and JustWatch links, keywords, top-billed cast, featured crew (directors, writers, creators), networks and episode count for TV, budget and revenue for movies, and the page's streaming summary (e.g. 'Now Streaming on Netflix'). Addressed by media_type + tmdb_id or by a pasted themoviedb.org URL. - Instructions: Details of a known movie or show: when it came out, what it is about, who is in it, how it is rated, and whether TMDB shows it as streaming. - Cost: 5 credits per call - Capability file: [Get title](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_title) Accepted options: - `media_type` (string): Required with tmdb_id when no url is given. Example: `movie` - `tmdb_id` (number): TMDB id of the movie or show. Example: `10` - `url` (string): A themoviedb.org movie or TV URL (https://www.themoviedb.org/movie/220-east-of-eden); alternative to media_type + tmdb_id. Example: `` Response schema example: ```json { "backdrop_url": "https://media.themoviedb.org/t/p/w780/u7i1XtbOubq0xwRy2Zbgmox6g9W.jpg", "budget_usd": 2, "certification": "PG", "featured_crew": [ { "jobs": [ "Director" ], "name": "Elia Kazan", "person_id": 2746, "url": "https://www.themoviedb.org/person/2746-elia-kazan" }, { "jobs": [ "Novel" ], "name": "John Steinbeck", "person_id": 2747, "url": "https://www.themoviedb.org/person/2747-john-steinbeck" }, { "jobs": [ "Screenplay" ], "name": "Paul Osborn", "person_id": 2748, "url": "https://www.themoviedb.org/person/2748-paul-osborn" } ], "first_air_date": null, "genres": [ "Drama" ], "homepage": "https://www.warnerbros.com/movies/east-eden", "justwatch_url": "https://www.justwatch.com/us/movie/east-of-eden", "keywords": [ "individual", "sibling relationship", "california", "rebel", "southern usa", "based on novel or book", "birthday", "big wheel", "twin brother", "love", "money", "brother against brother", "brothel madam", "whorehouse", "beans", "1910s", "fraternal twins", "monterey", "mother son reunion" ], "last_air_date": null, "media_type": "movie", "networks": [], "number_of_episodes": null, "observed_at_ms": 1791923458854, "original_language": "English", "original_title": null, "overview": "In the Salinas Valley in and around World War I, Cal Trask feels he must compete against overwhelming odds with his brother for the love of their father. Cal is frustrated at every turn, from his reaction to the war, how to get ahead in business and in life, and how to relate to his estranged mother.", "poster_url": "https://media.themoviedb.org/t/p/w500/xv1MZVIop0SQqwLUymgE5eb2LFl.jpg", "release_date": "1955-04-10", "revenue_usd": 5000000, "runtime_minutes": 115, "status": "Released", "tagline": "Sometimes you can't tell who's good and who's bad! ...", "title": "East of Eden", "tmdb_id": 220, "top_cast": [ { "character": "Cal Trask", "name": "James Dean", "person_id": 2749, "url": "https://www.themoviedb.org/person/2749-james-dean" }, { "character": "Abra Bacon", "name": "Julie Harris", "person_id": 2750, "url": "https://www.themoviedb.org/person/2750-julie-harris" }, { "character": "Adam Trask", "name": "Raymond Massey", "person_id": 2669, "url": "https://www.themoviedb.org/person/2669-raymond-massey" }, { "character": "Aron Trask", "name": "Richard Davalos", "person_id": 2751, "url": "https://www.themoviedb.org/person/2751-richard-davalos" }, { "character": "Kate Trask", "name": "Jo Van Fleet", "person_id": 2752, "url": "https://www.themoviedb.org/person/2752-jo-van-fleet" }, { "character": "Sam the Sheriff", "name": "Burl Ives", "person_id": 2753, "url": "https://www.themoviedb.org/person/2753-burl-ives" }, { "character": "Will Hamilton", "name": "Albert Dekker", "person_id": 2755, "url": "https://www.themoviedb.org/person/2755-albert-dekker" }, { "character": "Anne", "name": "Lois Smith", "person_id": 2207, "url": "https://www.themoviedb.org/person/2207-lois-smith" }, { "character": "Gustav Albrecht", "name": "Harold Gordon", "person_id": 2756, "url": "https://www.themoviedb.org/person/2756-harold-gordon" } ], "type": null, "url": "https://www.themoviedb.org/movie/220-east-of-eden", "user_score_percent": 75, "vote_average": 7.527, "vote_count": 842, "watch_summary": { "label": "Available to Rent or Buy", "provider_name": "Google Play Movies", "watch_url": "https://www.themoviedb.org/movie/220-east-of-eden/watch" }, "year": 1955 } ``` ### Get watch providers - Capability: `films/get_watch_providers` - Description: Where a movie or TV show can be watched in one country, as TMDB's JustWatch-powered watch panel lists it: stream, free, ads, rent and buy offers with provider name and JustWatch provider id, presentation quality (SD/HD/4K), price and currency where the panel shows one, the JustWatch click-out link and the JustWatch title page. A title with no offers in that country returns an empty list with the panel's own sentence. - Instructions: Streaming availability: where to stream, rent or buy a title in a given country (ISO 3166-1 alpha-2, default US). - Cost: 5 credits per call - Capability file: [Get watch providers](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/get_watch_providers) Accepted options: - `country` (string): ISO 3166-1 alpha-2 country whose offers to list; default US. Pattern: ^[A-Za-z]{2}$. Example: `` - `media_type` (string): media_type Example: `movie` - `tmdb_id` (number): tmdb_id Example: `10` - `url` (string): A themoviedb.org movie or TV URL; alternative to media_type + tmdb_id. Example: `` Response schema example: ```json { "country": "US", "justwatch_url": "https://www.justwatch.com/us/movie/verity", "media_type": "movie", "observed_at_ms": 1791923478001, "offers": [ { "currency": "USD", "deep_link": "https://athome.fandango.com/content/browse/details/Verity/5209189", "justwatch_click_url": "https://click.justwatch.com/a?cx=eyJzY2hlbWEiOiJpZ2x1OmNvbS5zbm93cGxvd2FuYWx5dGljcy5zbm93cGxvdy9jb250ZXh0cy9qc29uc2NoZW1hLzEtMC0wIiwiZGF0YSI6W3sic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL2NsaWNrb3V0X2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMiIsImRhdGEiOnsicHJvdmlkZXIiOiJGYW5kYW5nbyBBdCBIb21lIiwibW9uZXRpemF0aW9uVHlwZSI6ImJ1eSIsInByZXNlbnRhdGlvblR5cGUiOiI0ayIsImN1cnJlbmN5IjoiVVNEIiwicHJpY2UiOjI0Ljk5LCJwYXJ0bmVySWQiOjYsInByb3ZpZGVySWQiOjcsImNsaWNrb3V0VHlwZSI6Imp3LWNvbnRlbnQtcGFydG5lci1leHBvcnQtYXBpIn19LHsic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL3RpdGxlX2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMCIsImRhdGEiOnsidGl0bGVJZCI6MTU2MjYyNSwib2JqZWN0VHlwZSI6Im1vdmllIiwiandFbnRpdHlJZCI6InRtMTU2MjYyNSJ9fV19&r=https%3A%2F%2Fathome.fandango.com%2Fcontent%2Fbrowse%2Fdetails%2FVerity%2F5209189&uct_country=us", "justwatch_title_id": "tm1562625", "presentation_type": "4k", "price": 24.99, "provider_id": 7, "provider_logo_url": "https://media.themoviedb.org/t/p/original/wpOt6x0dRxTrIzuBosto4LGd7E9.png", "provider_name": "Fandango At Home", "type": "buy" }, { "currency": "USD", "deep_link": "https://athome.fandango.com/content/browse/details/Verity/5209189", "justwatch_click_url": "https://click.justwatch.com/a?cx=eyJzY2hlbWEiOiJpZ2x1OmNvbS5zbm93cGxvd2FuYWx5dGljcy5zbm93cGxvdy9jb250ZXh0cy9qc29uc2NoZW1hLzEtMC0wIiwiZGF0YSI6W3sic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL2NsaWNrb3V0X2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMiIsImRhdGEiOnsicHJvdmlkZXIiOiJGYW5kYW5nbyBBdCBIb21lIiwibW9uZXRpemF0aW9uVHlwZSI6ImJ1eSIsInByZXNlbnRhdGlvblR5cGUiOiJoZCIsImN1cnJlbmN5IjoiVVNEIiwicHJpY2UiOjI0Ljk5LCJwYXJ0bmVySWQiOjYsInByb3ZpZGVySWQiOjcsImNsaWNrb3V0VHlwZSI6Imp3LWNvbnRlbnQtcGFydG5lci1leHBvcnQtYXBpIn19LHsic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL3RpdGxlX2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMCIsImRhdGEiOnsidGl0bGVJZCI6MTU2MjYyNSwib2JqZWN0VHlwZSI6Im1vdmllIiwiandFbnRpdHlJZCI6InRtMTU2MjYyNSJ9fV19&r=https%3A%2F%2Fathome.fandango.com%2Fcontent%2Fbrowse%2Fdetails%2FVerity%2F5209189&uct_country=us", "justwatch_title_id": "tm1562625", "presentation_type": "hd", "price": 24.99, "provider_id": 7, "provider_logo_url": "https://media.themoviedb.org/t/p/original/wpOt6x0dRxTrIzuBosto4LGd7E9.png", "provider_name": "Fandango At Home", "type": "buy" }, { "currency": "USD", "deep_link": "https://athome.fandango.com/content/browse/details/Verity/5209189", "justwatch_click_url": "https://click.justwatch.com/a?cx=eyJzY2hlbWEiOiJpZ2x1OmNvbS5zbm93cGxvd2FuYWx5dGljcy5zbm93cGxvdy9jb250ZXh0cy9qc29uc2NoZW1hLzEtMC0wIiwiZGF0YSI6W3sic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL2NsaWNrb3V0X2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMiIsImRhdGEiOnsicHJvdmlkZXIiOiJGYW5kYW5nbyBBdCBIb21lIiwibW9uZXRpemF0aW9uVHlwZSI6ImJ1eSIsInByZXNlbnRhdGlvblR5cGUiOiJzZCIsImN1cnJlbmN5IjoiVVNEIiwicHJpY2UiOjI0Ljk5LCJwYXJ0bmVySWQiOjYsInByb3ZpZGVySWQiOjcsImNsaWNrb3V0VHlwZSI6Imp3LWNvbnRlbnQtcGFydG5lci1leHBvcnQtYXBpIn19LHsic2NoZW1hIjoiaWdsdTpjb20uanVzdHdhdGNoL3RpdGxlX2NvbnRleHQvanNvbnNjaGVtYS8xLTMtMCIsImRhdGEiOnsidGl0bGVJZCI6MTU2MjYyNSwib2JqZWN0VHlwZSI6Im1vdmllIiwiandFbnRpdHlJZCI6InRtMTU2MjYyNSJ9fV19&r=https%3A%2F%2Fathome.fandango.com%2Fcontent%2Fbrowse%2Fdetails%2FVerity%2F5209189&uct_country=us", "justwatch_title_id": "tm1562625", "presentation_type": "sd", "price": 24.99, "provider_id": 7, "provider_logo_url": "https://media.themoviedb.org/t/p/original/wpOt6x0dRxTrIzuBosto4LGd7E9.png", "provider_name": "Fandango At Home", "type": "buy" } ], "summary": "Verity is currently available to buy in the United States. JustWatch makes it easy to find out where you can legally watch your favorite movies & TV shows online. Visit JustWatch for more information.", "tmdb_id": 1283515, "url": "https://www.themoviedb.org/movie/1283515/watch?locale=US" } ``` ### Search - Capability: `films/search` - Description: Search TMDB for movies, TV shows and people by name through the site's suggest endpoint (one page of up to about 10 hits, ranked as the site ranks them). Each hit carries the TMDB id and media type needed by the other functions, the title, year, overview, poster, vote average and count. People carry their known-for department and up to three known-for titles. An unknown name returns an empty list. - Instructions: Resolve a title or person name to a TMDB id and media type before calling get_title, get_credits, get_watch_providers, get_release_dates, get_person or get_season. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/themoviedb-org/films/search) Accepted options: - `media_type` (string): Keep only hits of this media type; default `multi` keeps every type. Example: `multi` - `query` (string, required): Title or person name to search for; must contain a non-whitespace character. Example: `` Response schema example: ```json { "media_type": "multi", "observed_at_ms": 1791923448884, "query": "East of Eden", "results": [ { "known_for": [], "known_for_department": null, "media_type": "movie", "original_title": "East of Eden", "overview": "In the Salinas Valley in and around World War I, Cal Trask feels he must compete against overwhelming odds with his brother for the love of their father. Cal is frustrated at every turn, from his reaction to the war, how to get ahead in business and in life, and how to relate to his estranged mother.", "popularity": 14.308, "poster_url": "https://media.themoviedb.org/t/p/w500/xv1MZVIop0SQqwLUymgE5eb2LFl.jpg", "release_date": "1955-04-10", "title": "East of Eden", "tmdb_id": 220, "url": "https://www.themoviedb.org/movie/220", "vote_average": 7.527, "vote_count": 842, "year": 1955 }, { "known_for": [], "known_for_department": null, "media_type": "tv", "original_title": "East of Eden", "overview": "In the early 1900s, a fiercely independent woman drives a rift between two brothers, igniting a saga that unfolds across two generations.", "popularity": 79.0867, "poster_url": "https://media.themoviedb.org/t/p/w500/axdUor6gLMTrrB1UF4Qfy0TTSyX.jpg", "release_date": "2026-10-01", "title": "East of Eden", "tmdb_id": 258165, "url": "https://www.themoviedb.org/tv/258165", "vote_average": 8, "vote_count": 70, "year": 2026 } ] } ```