PHPackages                             dopelgan/metacritic-scraper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. dopelgan/metacritic-scraper

ActiveLibrary[API Development](/categories/api)

dopelgan/metacritic-scraper
===========================

Library for retrieving movie, game, album, tv, person, video, company, story information from metacritic.com

v0.9.0-beta(2y ago)00MITPHPPHP >=7.3

Since Mar 4Pushed 2y agoCompare

[ Source](https://github.com/Dopelgan/metacritic-scraper)[ Packagist](https://packagist.org/packages/dopelgan/metacritic-scraper)[ Docs](https://github.com/hooshid/metacritic-scraper)[ RSS](/packages/dopelgan-metacritic-scraper/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Metacritic Scraper
==================

[](#metacritic-scraper)

[![Build Status](https://github.com/hooshid/metacritic-scraper/workflows/tests/badge.svg)](https://github.com/hooshid/metacritic-scraper/actions)[![Total Downloads](https://camo.githubusercontent.com/e6bdccb253447b707eef05146aeead39eb298d3b1179bb73e49c69020844d119/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f6f736869642f6d6574616372697469632d73637261706572)](https://packagist.org/packages/hooshid/metacritic-scraper)[![Latest Stable Version](https://camo.githubusercontent.com/9c2fac52534f94572d6445000f03071d9770d8af4411dd7f320e579ea35c504d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f6f736869642f6d6574616372697469632d73637261706572)](https://packagist.org/packages/hooshid/metacritic-scraper)[![License](https://camo.githubusercontent.com/f870d9fc2f0f0cbaeb2bfad57273d522b2609ea192ccda33f29d3a9954bbc2ab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f686f6f736869642f6d6574616372697469632d73637261706572)](LICENSE.md)

Using this Metacritic API, you are able to search, browse and extract data of movies, tv series, musics and games on metacritic.com.

Install
-------

[](#install)

This library scrapes metacritic.com so changes their site can cause parts of this library to fail. You will probably need to update a few times a year.

### Requirements

[](#requirements)

- PHP >= 7.3
- PHP cURL extension

### Install via composer

[](#install-via-composer)

```
$ composer require dopelgan/metacritic-scraper
```

Run examples
------------

[](#run-examples)

The example gives you a quick demo to make sure everything's working, some sample code and lets you easily see some available data.

From the example folder in the root of this repository start up php's inbuilt webserver and browse to http://localhost:8000

`php -S localhost:8000`

Examples
--------

[](#examples)

### Get movie data

[](#get-movie-data)

#### Movie: The Matrix (1999) / URL:

[](#movie-the-matrix-1999--url-httpswwwmetacriticcommoviethe-matrix)

```
$metacritic = new Hooshid\MetacriticScraper\Metacritic();
$extract = $metacritic->extract("/movie/the-matrix");
$result = $extract['result'];
$error = $extract['error'];

// get all available data as json
echo json_encode($extract);
```

in above example we first create a new obj from Metacritic() class, then we call extract method and give the metacritic.com url in first param.

if everything ok, result key filled and if not, the error key filled with error occurred

#### Tv Series: Game of Thrones (2011-2019) / URL:

[](#tv-series-game-of-thrones-2011-2019--url-httpswwwmetacriticcomtvgame-of-thrones)

```
$metacritic = new Hooshid\MetacriticScraper\Metacritic();
$extract = $metacritic->extract("/tv/game-of-thrones");
$result = $extract['result'];
$error = $extract['error'];

if ($error) {
    echo $error;
} else {
    echo $result['type']; // type (movie, tv, game, person and ...)
    echo $result['title']; // movie/series title
    echo $result['thumbnail']; // Poster thumbnail
    echo $result['summary']; // Summary
    echo $result['release_year']; // Release year
    echo $result['must_see']; // Must see?

    echo $result['meta_score']; // Meta Score
    echo $result['meta_votes']; // Meta Votes
    echo $result['user_score']; // User Score
    echo number_format($result['user_votes']); // User Votes
}
```

you must always catch error first and get results.

### Search

[](#search)

```
$metacritic = new Hooshid\MetacriticScraper\Metacritic();
$result = $metacritic->search("it");

// get all available data as json
echo json_encode($result);
```

```
$metacritic = new Hooshid\MetacriticScraper\Metacritic();
$result = $metacritic->search("it", 0, "movie");

// output
{
  "results": [
    {
      "full_url": "https://www.metacritic.com/movie/it",
      "url": "/movie/it",
      "url_slug": "it",
      "title": "It",
      "description": "When children begin to disappear in the town of Derry, Maine, a group of young kids are faced with their biggest fears when they square off against an evil clown named Pennywise, whose history of...",
      "thumbnail": "https://static.metacritic.com/images/products/movies/8/ae92ae06d681d7eb2b0374d47787f3f8-78.jpg",
      "year": 2017,
      "type": "movie",
      "meta_score": 69,
      "must_see": false,
      "score_class": "positive"
    },
    {
        ...
    }
  ],
  "paginate": {
    "current_page": 0,
    "last_page": 16,
    "per_page": 10
  }
}
```

in above example we give 2 new param to method, $page must be integer as paginate.

$type by default return all, but you can specify this param to (all, movie, tv, game, album, music, person, video, company, story)

### Full examples

[](#full-examples)

just open the example folder, we put all examples and methods demo for you in there!

Related projects
----------------

[](#related-projects)

- [IMDb Scraper](https://github.com/hooshid/imdb-scraper)
- [Rottentomatoes Scraper](https://github.com/hooshid/rottentomatoes-scraper)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity22

Early-stage or recently created project

 Bus Factor1

Top contributor holds 82.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

798d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dcedbf4bd70fff4e6a9c8a056500872a50c68f62da1fe1483506097b3647d909?d=identicon)[Dopelgan](/maintainers/Dopelgan)

---

Top Contributors

[![arkamali](https://avatars.githubusercontent.com/u/17387297?v=4)](https://github.com/arkamali "arkamali (23 commits)")[![Dopelgan](https://avatars.githubusercontent.com/u/127526222?v=4)](https://github.com/Dopelgan "Dopelgan (4 commits)")[![hooshid-company](https://avatars.githubusercontent.com/u/63948394?v=4)](https://github.com/hooshid-company "hooshid-company (1 commits)")

---

Tags

phpapiparserscraperscrapingmetacriticmetacritic.commetacritic-webscrappingmetacritic-scrapingmetacritic-scrapermetacritic-metadata

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dopelgan-metacritic-scraper/health.svg)

```
[![Health](https://phpackages.com/badges/dopelgan-metacritic-scraper/health.svg)](https://phpackages.com/packages/dopelgan-metacritic-scraper)
```

###  Alternatives

[duzun/hquery

An extremely fast web scraper that parses megabytes of HTML in a blink of an eye. No dependencies. PHP5+

363146.3k4](/packages/duzun-hquery)[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)