# IMDb API: List top charts > Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles. Unofficial. Not affiliated with or endorsed by IMDb. - Page: https://fous.com/methods/imdb.com/list-top-charts - Method: `imdb.com/list_top_charts`, version 1 - Website: imdb.com - Returns: rank, title, year, IMDb rating, votes, runtime, age rating, IMDb link, weekly rank change, title ID, runtime minutes - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `chart` | string | no | `"top_250_movies"` | Chart to list, for example top_250_movies. One of "top_250_movies", "top_250_tv_shows", "most_popular_movies", "most_popular_tv_shows". Default "top_250_movies". | | `max_results` | integer | no | `50` | Maximum number of titles, for example 50. Popular charts have at most 100 titles. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "chart": "top_250_movies", "max_results": 50 } ``` Its output: ```json { "titles": [ { "rank": 1, "year": 1994, "title": "The Shawshank Redemption", "votes": 3244669, "runtime": "2 h 22 min", "title_id": "tt0111161", "imdb_link": "https://www.imdb.com/title/tt0111161/", "age_rating": "R", "imdb_rating": 9.3, "runtime_minutes": 142, "rank_change_since_last_week": null }, { "rank": 2, "year": 1972, "title": "The Godfather", "votes": 2259997, "runtime": "2 h 55 min", "title_id": "tt0068646", "imdb_link": "https://www.imdb.com/title/tt0068646/", "age_rating": "R", "imdb_rating": 9.2, "runtime_minutes": 175, "rank_change_since_last_week": null }, { "rank": 3, "year": 2008, "title": "The Dark Knight", "votes": 3232530, "runtime": "2 h 32 min", "title_id": "tt0468569", "imdb_link": "https://www.imdb.com/title/tt0468569/", "age_rating": "PG-13", "imdb_rating": 9.1, "runtime_minutes": 152, "rank_change_since_last_week": null } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"imdb.com/list_top_charts","input":{"chart":"top_250_movies","max_results":50}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Show me the top 20 highest-rated movies of all time on IMDb with their ratings and vote counts - Which TV shows are trending most right now? Give me the top 50 along with how much each moved up or down in rank this week - I need the full list of 250 best-rated TV series, including year, runtime and age rating for each - What are the 10 most popular movies on IMDb this week? - Pull the first 100 entries from the all-time greatest films ranking with their title IDs and runtime in minutes ## Input schema ```json { "type": "object", "properties": { "chart": { "enum": [ "top_250_movies", "top_250_tv_shows", "most_popular_movies", "most_popular_tv_shows" ], "type": "string", "default": "top_250_movies", "description": "Chart to list, for example top_250_movies." }, "max_results": { "type": "integer", "default": 50, "maximum": 250, "minimum": 1, "description": "Maximum number of titles, for example 50. Popular charts have at most 100 titles." } } } ``` ## Output schema ```json { "type": "object", "required": [ "titles" ], "properties": { "titles": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "year", "imdb_rating", "votes", "runtime", "age_rating", "imdb_link", "rank_change_since_last_week", "title_id", "runtime_minutes" ], "properties": { "rank": { "type": "integer", "description": "Position in the chosen chart." }, "year": { "type": [ "integer", "null" ], "description": "First release year, if available." }, "title": { "type": "string", "description": "Movie or show title." }, "votes": { "type": [ "integer", "null" ], "description": "Number of IMDb rating votes, if available." }, "runtime": { "type": [ "string", "null" ], "description": "Runtime, such as 2 h 22 min, if available." }, "title_id": { "type": "string", "description": "IMDb title identifier." }, "imdb_link": { "type": "string", "description": "IMDb page for this title." }, "age_rating": { "type": [ "string", "null" ], "description": "Content rating, such as R or TV-MA, if available." }, "imdb_rating": { "type": [ "number", "null" ], "description": "IMDb audience rating out of 10, if available." }, "runtime_minutes": { "type": [ "integer", "null" ], "description": "Runtime in minutes, if available." }, "rank_change_since_last_week": { "type": [ "integer", "null" ], "description": "Weekly popularity chart rank change: positive means moved up, negative means moved down, zero means unchanged; null when unavailable or not a popularity chart." } } }, "description": "Titles in chart order." } } } ``` ## See more - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null. - [IMDb API: Get film person](https://fous.com/methods/imdb.com/get-person.md): Finds a film person on IMDb by name, IMDb person link or person ID and returns their biography, awards summary, known-for titles and filmography (without self-appearances, archive footage and thanks). - [IMDb API: Get IMDb Parents Guide](https://fous.com/methods/imdb.com/get-parents-guide.md): Gets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release. - [Roblox API: List top games](https://fous.com/methods/roblox.com/list-top-games.md): Lists ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link. - [JustWatch API: List streaming chart titles](https://fous.com/methods/justwatch.com/list-streaming-charts.md): Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service. - [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films. - [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes. - [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category. - [All IMDb methods](https://fous.com/methods/imdb.com.md)