Skip to content

Repository files navigation

🎬 Metacritic Scraper

Metacritic Scraper is a free and open-source scraper that gets you unlimited detailed Metacritic data for free.

✨ What Can I Get?

  • 🎬 Full details on 215K+ games, movies & TV shows — Metascore, user score, cast, crew, awards & trailers
  • ⭐ Every critic & user review — quote, score, publication, author & date, filterable by sentiment
  • 🔍 Browse like Metacritic — top rated, new, upcoming & trending by year, genre, platform & network
  • 📺 Seasons, episodes, people & prices — 386K+ people, TV episode scores, where to watch & where to buy

🎥 Example: A Full Metacritic Movie

{
  "id": 2000556373,
  "type": "movie",
  "title": "Oppenheimer",
  "link": "https://www.metacritic.com/movie/oppenheimer/",
  "tagline": "The World Forever Changes",
  "release_date": "2023-07-21",
  "rating": "R",
  "duration_minutes": 180,
  "genres": ["Biography", "Drama", "History"],
  "metascore": { "score": 90, "max": 100, "review_count": 69, "positive_count": 67, "sentiment": "Universal acclaim" },
  "user_score": { "score": 8.4, "max": 10, "review_count": 2275, "positive_count": 1995, "sentiment": "Universal acclaim" },
  "awards": [
    { "event": "Academy Awards, USA", "wins_count": 7, "nominations_count": 13 }
  ],
  "cast": [
    { "name": "Cillian Murphy", "roles": ["J. Robert Oppenheimer"], "link": "https://www.metacritic.com/person/cillian-murphy/" }
  ],
  "crew": [
    { "name": "Christopher Nolan", "roles": ["Director"], "group": "Directed By" }
  ],
  "critic_reviews": {
    "review_count": 69,
    "featured": [
      {
        "quote": "Christopher Nolan deserves every superlative for his brilliant take on J. Robert Oppenheimer (a flawless Cillian Murphy), the dark knight of the atomic age.",
        "score": 100,
        "date": "2023-07-21",
        "publication": { "name": "ABC News", "slug": "abc-news" },
        "author": { "name": "Peter Travers", "slug": "peter-travers" }
      }
    ]
  },
  "imdb_id": "tt15398776",
  "video": { "title": "Oppenheimer: Atmosphere (UK Spot)", "stream_link": "https://cdn.jwplayer.com/manifests/344YnWRS.m3u8" }
}

Trimmed for readability.

🚀 Unlimited Free Metacritic Data — Get It in 60 Seconds

1️⃣ Clone and install:

git clone https://github.com/omkarcloud/metacritic-scraper
cd metacritic-scraper
python -m pip install -r requirements.txt

2️⃣ Start the API:

python run.py

3️⃣ Get your first data:

curl "http://localhost:8000/movies/details?movie=oppenheimer"
{
  "id": 2000556373,
  "type": "movie",
  "title": "Oppenheimer",
  "link": "https://www.metacritic.com/movie/oppenheimer/",
  "release_date": "2023-07-21",
  "rating": "R",
  "duration_minutes": 180,
  "genres": ["Biography", "Drama", "History"],
  "metascore": { "score": 90, "review_count": 69, "sentiment": "Universal acclaim" },
  "user_score": { "score": 8.4, "review_count": 2275, "sentiment": "Universal acclaim" },
  "crew": [
    { "name": "Christopher Nolan", "roles": ["Director"] }
  ],
  "cast": [
    { "name": "Cillian Murphy", "roles": ["J. Robert Oppenheimer"] },
    { "name": "Emily Blunt", "roles": ["Kitty Oppenheimer"] }
  ],
  "awards": [
    { "event": "Academy Awards, USA", "wins_count": 7, "nominations_count": 13 }
  ]
}

All 36 endpoints are now live at http://localhost:8000.

📚 Endpoints

36 endpoints cover everything you need.

Endpoint Path Returns
Movie / TV Show / Game Details /movies/details, /shows/details, /games/details The whole title page in one call: scores, cast, awards, top reviews
Search /search, /search/counts Games, movies, shows and people matching any phrase
Scores /titles/scores Metascore and user score, per platform for games
Critic / User Reviews /titles/critic-reviews, /titles/user-reviews Every review with quote, score, author and date
Reviews Summary /titles/reviews-summary Both scores plus best positive, mixed and negative reviews
Related Titles /titles/related Best-scored titles like this one
Where to Watch / Buy /titles/where-to-watch, /games/where-to-buy US streaming offers and game retailer prices
Player Stats /games/stats GameFAQs play time, difficulty and completion
Title News /titles/news News and features about one title
Browse /browse, /browse/filters Every title filtered by year, genre, platform, network, score
Top Rated / New / Upcoming /top-rated, /new-releases, /upcoming Best, newest and coming-soon titles
In Theaters / Trending / Featured /in-theaters, /trending, /featured What's hot right now and editor picks
TV Seasons & Episodes /shows/seasons, /shows/season, /shows/episodes, /shows/episode Season scores, episode lists and episode details
TV Season Reviews /shows/season/critic-reviews, /shows/season/user-reviews Critic and user reviews of one season
Person Details / Credits /people/details, /people/credits Profiles and full filmographies with Metascores
Publications /publications/details, /publications/reviews A critic outlet's stats and every review it wrote
User Stats /users/stats A member's review counts, averages, best and worst picks
News / Article / Videos /news, /news/article, /videos Latest news, full articles and trailers

🔍 Exploring Parameters

The same API is published on RapidAPI, and its playground is the easiest place to try parameters and see raw responses. Once a request looks right, run it locally for unlimited free data.

  1. Subscribe to the free plan — 1,000 calls/month, no credit card.
  2. Try the endpoints in the playground — every param is pre-filled, so you see real data in one click.
  3. Copy the generated code and replace https://best-metacritic-scraper-free-1000-calls.p.rapidapi.com with http://localhost:8000. It will now run against your local API.
import requests

# generated by the playground, host swapped for the local API
response = requests.get(
    "http://localhost:8000/movies/details",
    params={"movie": "oppenheimer"},
)
print(response.json())

💬 Have Questions? We Have Answers.

You're a developer — we know how hard completing a project can be. So we offer full support: just message us and we'll reply ✅ with a solution within 1 working day.

Message Us on WhatsApp about Metacritic Scraper

Ask Us by Email about Metacritic Scraper

⚡ Popular Scrapers by Omkar Cloud

⭐ Love It? Star It ⭐!

Star the repo ⭐ and become a star hero!

It's just 1 click, but it means the world to me.

Star us on GitHub

Releases

Packages

Contributors

Languages