MetaCritic API
An unofficial API for accessing MetaCritic data across games, movies, and TV shows. It provides endpoints for browsing titles, searching across media types, retrieving detailed title information, and exploring new, upcoming, and top-rated releases with flexible filtering for platform, genre, network, release type, and more. General pay-per-use pricing after a free tier, with subscription plans…
MetaCritic API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Main | ||
| GET |
Browse for media /main/browse/{mediaType}/{sort} |
Retrieve a list of media items (games, movies, or shows) with optional filtering and sorting. Results can be filtered by release year, platform/network, genre, and release type.… |
| GET |
Search for media or people /main/search/{searchText} |
Search across all media types including games, movies, shows, and people. Results are ranked by relevance by default and include detailed metadata for each match. |
| Game | ||
| GET |
Get game details /game/{titleId} |
Retrieve full details for a specific game, including metadata, review scores, latest critic reviews, and latest user reviews. |
| GET |
Get upcoming game releases /game/upcoming-releases/ |
Retrieve upcoming games that have not yet been released, optionally filtered by platform and/or genre. |
| GET |
Get new game releases /game/new-releases/ |
Retrieve the most recently released games sorted by release date, optionally filtered by platform and/or genre. |
| GET |
Get top-rated games of the current year /game/current-year/top-rated/ |
Retrieve the highest-rated games released in the current calendar year by Metascore, optionally filtered by platform and/or genre. |
| GET |
Get best games of the current year /game/current-year/best/ |
Retrieve the top 20 best games of the current year ranked by combined critic and user score, optionally filtered by platform and/or genre. |
| GET |
Get top-rated games of all time /game/all-time/top-rated/ |
Retrieve the highest-rated games of all time by Metascore, optionally filtered by platform and/or genre. |
| GET |
Get best games of all time /game/all-time/best/ |
Retrieve the top 20 best games of all time ranked by combined critic and user score, optionally filtered by platform and/or genre. |
| Movie | ||
| GET |
Get movie details /movie/{titleId} |
Retrieve full details for a specific movie, including metadata, cast, crew, review scores, critic reviews, and user reviews. |
| GET |
Get upcoming movie releases /movie/upcoming-releases/ |
Retrieve movies that are coming soon, optionally filtered by network and/or genre. |
| GET |
Get new movie releases /movie/new-releases/ |
Retrieve the most recently released movies sorted by release date, optionally filtered by network and/or genre. |
| GET |
Get top-rated movies in theaters now /movie/in-theaters/top-rated/ |
Retrieve the highest-rated movies currently playing in theaters, optionally filtered by genre. |
| GET |
Get best movies in theaters now /movie/in-theaters/best/ |
Retrieve the top 20 best movies currently in theaters ranked by combined critic and user score, optionally filtered by genre. |
| GET |
Get top-rated movies of the current year /movie/current-year/top-rated/ |
Retrieve the highest-rated movies released in the current calendar year by Metascore, optionally filtered by network and/or genre. |
| GET |
Get best movies of the current year /movie/current-year/best/ |
Retrieve the top 20 best movies of the current year ranked by combined critic and user score, optionally filtered by network and/or genre. |
| GET |
Get top-rated movies of all time /movie/all-time/top-rated/ |
Retrieve the highest-rated movies of all time by Metascore, optionally filtered by network and/or genre. |
| GET |
Get best movies of all time /movie/all-time/best/ |
Retrieve the top 20 best movies of all time ranked by combined critic and user score, optionally filtered by network and/or genre. |
| Show | ||
| GET |
Get show details /show/{titleId} |
Retrieve full details for a specific show, including metadata, cast, crew, review scores, latest critic reviews and user reviews. |
| GET |
Get upcoming show releases /show/upcoming-releases/ |
Retrieve shows that are coming soon, optionally filtered by network and/or genre. |
| GET |
Get new show releases /show/new-releases/ |
Retrieve the most recently released shows sorted by release date, optionally filtered by network and/or genre. |
| GET |
Get top-rated shows of the current year /show/current-year/top-rated/ |
Retrieve the highest-rated TV shows released in the current calendar year by Metascore, optionally filtered by network and/or genre. |
| GET |
Get best shows of the current year /show/current-year/best/ |
Retrieve the top 20 best TV shows of the current year ranked by combined critic and user score, optionally filtered by network and/or genre. |
| GET |
Get top-rated shows of all time /show/all-time/top-rated/ |
Retrieve the highest-rated TV shows of all time by Metascore, optionally filtered by network and/or genre. |
| GET |
Get best shows of all time /show/all-time/best/ |
Retrieve the top 20 best TV shows of all time ranked by combined critic and user score, optionally filtered by network and/or genre. |
| Other endpoints | ||
| GET |
Get best rated shows of the current year /show/best/current-year/ |
Returns the highest rated shows released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Browse for media /main/browse/{mediaType}/{sort} |
Browse media content with optional filters. Args: request (Request): FastAPI request object media_type (MediaType): Type of media to browse sort (BrowseSort): Sort order for… |
| GET |
Get game details /game/{titleId} |
Returns detailed information about a specific game from MetaCritic. Includes title, summary, release date, critic/user reviews, and scores. Args: game_name (str): Name of the… |
| GET |
Get game details /game/{titleId} |
Returns detailed information about a specific game from MetaCritic. Includes title, summary, release date, critic/user reviews, and scores. Args: game_name (str): Name of the… |
| GET |
Browse for media /main/browse/{mediaType}/{sort} |
Browse media content with optional filters. Args: request (Request): FastAPI request object media_type (MediaType): Type of media to browse sort (BrowseSort): Sort order for… |
| GET |
Get movie details /movie/{titleId} |
Returns detailed information about a specific movie from MetaCritic. Includes title, summary, release date, critic/user reviews and scores. Args: titleId (str): Title ID of the… |
| GET |
Get best rated shows of the current year /show/best/current-year/ |
Returns the highest rated shows released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Get movie details /movie/{titleId} |
Returns detailed information about a specific movie from MetaCritic. Includes title, summary, release date, critic/user reviews and scores. Args: titleId (str): Title ID of the… |
| GET |
Get new game releases /game/new-releases/ |
Returns the latest games released for all platforms. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object platform: Platform(s) to filter… |
| GET |
Get best rated movies of the current year /movie/best/current-year/ |
Returns the highest rated movies released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Get new game releases /game/new-releases/ |
Returns the latest games released for all platforms. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object platform: Platform(s) to filter… |
| GET |
Get best rated shows of all time /show/best/all-time/ |
Returns the highest rated shows released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
Get best rated shows of all time /show/best/all-time/ |
Returns the highest rated shows released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
Get best rated movies of the current year /movie/best/current-year/ |
Returns the highest rated movies released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Search for media or people /main/search/{searchText} |
Search across all media types. Args: searchText (str): Text to search for mediaType: Type of media to search (all/game/movie/show/person) sortBy: Sort order for results… |
| GET |
Search for media or people /main/search/{searchText} |
Search across all media types. Args: searchText (str): Text to search for mediaType: Type of media to search (all/game/movie/show/person) sortBy: Sort order for results… |
| GET |
Get best rated games of the current year /game/best/current-year/ |
Returns the highest rated games released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Get best rated movies of all time /movie/best/all-time/ |
Returns the highest rated movies released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
Get best rated movies of all time /movie/best/all-time/ |
Returns the highest rated movies released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
Get best rated games of the current year /game/best/current-year/ |
Returns the highest rated games released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for… |
| GET |
Get best rated games of all time /game/best/all-time/ |
Returns the highest rated games released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
Get best rated games of all time /game/best/all-time/ |
Returns the highest rated games released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object page: Page number for results… |
| GET |
get_best_all_time_games_game_best_all_time__get /game/best/all-time/ |
Returns the highest rated games released for all time. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object platform: Platform(s) to… |
| GET |
get_new_releases_games_game_new_releases__get /game/new-releases/ |
Returns the latest games released for all platforms. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object platform: Platform(s) to filter… |
| GET |
get_best_current_year_games_game_best_current_year__get /game/best/current-year/ |
Returns the highest rated games released in the current year. Uses the browse endpoint with pre-configured filters. Args: request: Injected request object platform: Platform(s)… |
MetaCritic API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | Free | 1 / second |
|
| ULTRA | $4.95 / month | 2 / second |
|
| MEGA | $14.95 / month | 3 / second |
|