# Metacritic API: List best-reviewed titles > Lists the highest-Metascore games, movies or TV shows on Metacritic for a release year or all time. You can filter by genre, and by platform for games. Unofficial. Not affiliated with or endorsed by Metacritic. - Page: https://fous.com/methods/metacritic.com/list-best-reviewed - Method: `metacritic.com/list_best_reviewed`, version 1 - Website: metacritic.com - Returns: rank, title, metascore, user score, release date, platform, link - 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 | |---|---|---|---|---| | `type` | string | no | `"movie"` | What kind of title to list, for example game. One of "game", "movie", "tv". Default "game". | | `year` | string | no | `"2025"` | Release year, all_time, or current_year; for example 2025. Default "current_year". | | `genre` | string | no | `"Drama"` | Genre, for example Action RPG; use all for every genre. Default "all". | | `platform` | string | no | | Game platform, for example Nintendo Switch; use all for every platform. Default "all". | | `max_results` | integer | no | `55` | Maximum number of titles to return, for example 25 (up to 100). Default 25. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "type": "movie", "year": "2025", "genre": "Drama", "max_results": 55 } ``` Its output: ```json { "titles": [ { "link": "https://www.metacritic.com/movie/the-secret-agent-2025/", "rank": 1, "title": "The Secret Agent", "platform": null, "metascore": 91, "user_score": 7.4, "release_date": "2025-11-26" }, { "link": "https://www.metacritic.com/movie/it-was-just-an-accident/", "rank": 2, "title": "It Was Just an Accident", "platform": null, "metascore": 91, "user_score": 7.4, "release_date": "2025-10-15" }, { "link": "https://www.metacritic.com/movie/sorry-baby/", "rank": 3, "title": "Sorry, Baby", "platform": null, "metascore": 90, "user_score": 7.3, "release_date": "2025-06-27" } ] } ``` ## 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":"metacritic.com/list_best_reviewed","input":{"type":"movie","year":"2025","genre":"Drama","max_results":55}}' ``` 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 highest-rated games of 2025 on Metacritic - What are the best-reviewed movies of all time? - List the top Action RPG games on PlayStation 5 by critic score - Top 10 best-reviewed TV shows from 2023 - Which Nintendo Switch games have the highest Metascore this year? Show 15 results ## Input schema ```json { "type": "object", "properties": { "type": { "enum": [ "game", "movie", "tv" ], "type": "string", "default": "game", "description": "What kind of title to list, for example game." }, "year": { "type": "string", "default": "current_year", "description": "Release year, all_time, or current_year; for example 2025." }, "genre": { "type": "string", "default": "all", "description": "Genre, for example Action RPG; use all for every genre." }, "platform": { "type": "string", "default": "all", "description": "Game platform, for example Nintendo Switch; use all for every platform." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum number of titles to return, for example 25 (up to 100)." } } } ``` ## Output schema ```json { "type": "object", "required": [ "titles" ], "properties": { "titles": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "link" ], "properties": { "link": { "type": "string" }, "rank": { "type": "integer" }, "title": { "type": "string" }, "platform": { "type": [ "string", "null" ] }, "metascore": { "type": [ "integer", "null" ] }, "user_score": { "type": [ "number", "null" ] }, "release_date": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [Metacritic API: Get scores](https://fous.com/methods/metacritic.com/get-scores.md): Finds a game, movie or TV show on Metacritic by name and returns critic and user scores with title details. - [Rotten Tomatoes API: Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md): Reads the newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show it combines reviews from its seasons. - [Common Sense Media API: Get an age rating](https://fous.com/methods/commonsensemedia.org/get-age-rating.md): Finds the Common Sense Media review of a movie, TV show, game, book, app or podcast by title (optionally type and year) and returns its age rating, star rating, verdict and parents' guide. - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series. - [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates. - [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members. - [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles. - [Rotten Tomatoes API: List movies](https://fous.com/methods/rottentomatoes.com/list-movies.md): Lists Rotten Tomatoes movies in theaters, coming soon, or at home, by genre and site sort order, with scores, release dates, age ratings, posters and links. - [All Metacritic methods](https://fous.com/methods/metacritic.com.md)