PHPackages                             gboquizosanchez/screenscraper - 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. gboquizosanchez/screenscraper

ActiveLibrary[API Development](/categories/api)

gboquizosanchez/screenscraper
=============================

Laravel wrapper for ScreenScraper API

1.1.0(4mo ago)03MITPHPPHP ^8.3

Since Mar 1Pushed 2mo agoCompare

[ Source](https://github.com/gboquizosanchez/screenscraper)[ Packagist](https://packagist.org/packages/gboquizosanchez/screenscraper)[ Docs](https://github.com/gboquizosanchez)[ RSS](/packages/gboquizosanchez-screenscraper/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (6)Versions (4)Used By (0)

[![ScreenScraper](https://camo.githubusercontent.com/c887f3228e1750e3794d2115535d49de8b1d12dcefd96779aed78d2cef72504d/68747470733a2f2f7777772e73637265656e736372617065722e66722f696d616765732f6c6f676f2d353132783531322e706e67)](https://camo.githubusercontent.com/c887f3228e1750e3794d2115535d49de8b1d12dcefd96779aed78d2cef72504d/68747470733a2f2f7777772e73637265656e736372617065722e66722f696d616765732f6c6f676f2d353132783531322e706e67)`gboquizosanchez/screenscraper`
===============================

[](#gboquizosanchezscreenscraper)

**ScreenScraper.fr API client for Laravel**

[![Latest Stable Version](https://camo.githubusercontent.com/d6098d775d5da898f4be5d5f9f789e029f74526d69f51b482d7665be4190f730/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67626f7175697a6f73616e6368657a2f73637265656e736372617065722e737667)](https://packagist.org/packages/gboquizosanchez/screenscraper)[![Total Downloads](https://camo.githubusercontent.com/3a44f445b9bae138f3ca8ec9f2e524de6ad80aec8b275e084e17aa3488188a1f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67626f7175697a6f73616e6368657a2f73637265656e736372617065722e737667)](https://packagist.org/packages/gboquizosanchez/screenscraper)[![PHP](https://camo.githubusercontent.com/31a87e1f22b529af58a2615dde6bcd4902061209db5e98adc4b5dff3e99f5f02/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e332d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/gboquizosanchez/screenscraper)[![Laravel](https://camo.githubusercontent.com/cf3203afc4f003dc5656e6a684f11a5786224fdb31ec4c4848e807068c048bc2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d313125323025374325323031322d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/gboquizosanchez/screenscraper)[![License: MIT](https://camo.githubusercontent.com/6fd529fdc57adf8eb89582bee619d571fd9037b380418c50bb57e9c91598e03b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d3232433535452e737667)](LICENSE.md)

---

*Fetch game metadata, media, and platform data from ScreenScraper.fr directly in your Laravel app.*

---

Overview
--------

[](#overview)

A Laravel package that wraps the full [ScreenScraper API](https://www.screenscraper.fr/webapi2.php?alpha=0&numpage=0), giving you access to game info, artwork, ratings, and more — with optional DTO mapping via [spatie/laravel-data](https://github.com/spatie/laravel-data).

> **Note:** You need a ScreenScraper account and developer credentials to use this package. Register [here](https://www.screenscraper.fr/membreinscription.php) and request developer access [here](https://www.screenscraper.fr/forumsujets.php?frub=12&numpage=0).

---

📦 Installation
--------------

[](#-installation)

```
composer require gboquizosanchez/screenscraper
```

Add your credentials to `.env`:

```
SCREENSCRAPER_BASE_URL=https://api.screenscraper.fr/api2/
SCREENSCRAPER_OUTPUT=json
SCREENSCRAPER_USERNAME=your_username
SCREENSCRAPER_PASSWORD=your_password
SCREENSCRAPER_DEV_ID=your_dev_id
SCREENSCRAPER_DEV_PASSWORD=your_dev_password
SCREENSCRAPER_SOFTNAME="ScreenScraper API Client for Laravel"
SCREENSCRAPER_DTO_MAPPING=true
SCREENSCRAPER_RAW_MAPPING=false
```

Optionally, publish the configuration file:

```
php artisan vendor:publish --provider="ScreenScraper\ScreenScraperServiceProvider"
```

---

🚀 Usage
-------

[](#-usage)

### Via facade

[](#via-facade)

The facade reads credentials directly from your `.env`:

```
use ScreenScraper\ScreenScraperClient;

ScreenScraperClient::getGame(gameId: 1);
```

### Via the client directly

[](#via-the-client-directly)

Useful when working with multiple accounts or custom credentials:

```
use ScreenScraper\Data\AuthData;
use ScreenScraper\Models\ScreenScraper;

$auth = new AuthData(
    devId: 'your_dev_id',
    devPassword: 'your_dev_password',
    softname: 'Your App Name',
    output: 'json',
    ssid: 'your_username',
    sspassword: 'your_password',
);

$client = new ScreenScraper($auth);
$client->getGame(gameId: 1);
```

You can also use the default credentials from config:

```
$auth = new AuthData(...config('screenscraper.credentials'));
```

---

🗺️ Response mapping
-------------------

[](#️-response-mapping)

By default, the package maps responses to typed DTOs. You can switch to raw responses via `.env`:

```
# Default — typed DTOs via spatie/laravel-data
SCREENSCRAPER_DTO_MAPPING=true
SCREENSCRAPER_RAW_MAPPING=false

# Raw responses — disable DTO mapping first
SCREENSCRAPER_DTO_MAPPING=false
SCREENSCRAPER_RAW_MAPPING=true
```

> `RAW` mapping only works when `SCREENSCRAPER_DTO_MAPPING` is set to `false`.

---

📚 Available methods
-------------------

[](#-available-methods)

This package covers all endpoints from the [ScreenScraper API](https://www.screenscraper.fr/webapi2.php?alpha=0&numpage=0). See [`ScreenScraperClient`](src/ScreenScraperClient.php) for the full method list.

---

🧪 Testing
---------

[](#-testing)

```
composer test
```

---

Contributing
------------

[](#contributing)

Contributions are welcome!

- 🐛 **Report bugs** via [GitHub Issues](https://github.com/gboquizosanchez/screenscraper/issues/new)
- 💡 **Suggest features** or improvements
- 🔧 **Submit pull requests** with fixes or enhancements

---

Credits
-------

[](#credits)

- **Author**: [Germán Boquizo Sánchez](mailto:germanboquizosanchez@gmail.com)
- **Contributors**: [View all contributors](../../contributors)

---

📄 License
---------

[](#-license)

This package is open-source software licensed under the [MIT License](LICENSE.md).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance80

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Every ~0 days

Total

3

Last Release

125d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20032391?v=4)[Germán Boquizo Sánchez](/maintainers/gboquizosanchez)[@gboquizosanchez](https://github.com/gboquizosanchez)

---

Top Contributors

[![gboquizosanchez](https://avatars.githubusercontent.com/u/20032391?v=4)](https://github.com/gboquizosanchez "gboquizosanchez (5 commits)")

---

Tags

screenscraperapi-screenscraper

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/gboquizosanchez-screenscraper/health.svg)

```
[![Health](https://phpackages.com/badges/gboquizosanchez-screenscraper/health.svg)](https://phpackages.com/packages/gboquizosanchez-screenscraper)
```

###  Alternatives

[moe-mizrak/laravel-openrouter

Laravel package for OpenRouter (A unified interface for LLMs)

154177.9k2](/packages/moe-mizrak-laravel-openrouter)

PHPackages © 2026

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