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(2mo 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 1mo ago

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

[![ScreenScraper Logo](https://camo.githubusercontent.com/c887f3228e1750e3794d2115535d49de8b1d12dcefd96779aed78d2cef72504d/68747470733a2f2f7777772e73637265656e736372617065722e66722f696d616765732f6c6f676f2d353132783531322e706e67)](https://screenscraper.org)

ScreenScraper.org API Container for Laravel
===========================================

[](#screenscraperorg-api-container-for-laravel)

---

Summary
-------

[](#summary)

A library that lets you get data from ScreenScraper directly in your Laravel application.

Starting 🚀
----------

[](#starting-)

### Prerequisites 📋

[](#prerequisites-)

- Composer.
- PHP version 8.3 or higher.

Running 🛠️
----------

[](#running-️)

Install the package via composer:

```
composer require gboquizosanchez/screenscraper
```

Establish the configuration in the `.env` file:

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

You can also publish the configuration file to customize the package:

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

**Note**: You need to have a ScreenScraper account to use the API. If you don't have one, you can request one [here](https://www.screenscraper.fr/forumsujets.php?frub=12&numpage=0). And also, you need to have an account. You can get one on the register page.

Basic Usage 👷
-------------

[](#basic-usage-)

You can use two different methods:

### Using the facade

[](#using-the-facade)

This method provides directly from `.env` file the username and the web API key.

```
use ScreenScraper\ScreenScraperClient;

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

### Using the ScreenScraper model directly

[](#using-the-screenscraper-model-directly)

You can provide a custom username and password if you want to use different credentials.

Or, you can use the default ones from the `.env` using `config('screenscraper.credentials')`.

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

$auth = new AuthData(
    devId: developer_identifier,
    devPassword: developer_password,
    softname: software_name,
    output: json or xml,
    ssid: user_identifier,
    sspassword: user_password,
);

$client = new ScreenScraper($auth);

$client->getGame(gameId: 1);
```

### Mapping the response 🗺️

[](#mapping-the-response-️)

There are two ways to map the response. By default, the package uses the DTO mapping.

```
SCREENSCRAPER_DTO_MAPPING=true
SCREENSCRAPER_MAPPING=false
```

**Note**: If you want to use the raw mapping, you need to set the `SCREENSCRAPER_DTO_MAPPING` to `false` and the `SCREENSCRAPER_RAW_MAPPING` to `true`. RAW only works with DTO mapping disabled.

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

[](#available-methods-)

This package provides all methods available in the [ScreenScraper API](https://www.screenscraper.fr/webapi2.php?alpha=0&numpage=0).

See the [ScreenScraperClient facade](src/ScreenScraperClient.php) for more information.

Working with ⚙️
---------------

[](#working-with-️)

### PHP dependencies 📦

[](#php-dependencies-)

- Spatie Laravel Data [![Latest Stable Version](https://camo.githubusercontent.com/477c6cbcc52b0bd6e77f7bbaa833cd3a421edc0351d9842aaf4f1e9807bc3b3a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d342e31382e302d626c7565)](https://packagist.org/packages/spatie/laravel-data)

#### Develop dependencies 🔧

[](#develop-dependencies-)

- Friendsofphp Php Cs Fixer [![Latest Stable Version](https://camo.githubusercontent.com/c23f44943c7c9a2b1f9881dd1a894f89899048f9a9cb33b06ae365780aca3d90/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d76332e39322e352d626c7565)](https://packagist.org/packages/friendsofphp/php-cs-fixer)
- Hermes Dependencies [![Latest Stable Version](https://camo.githubusercontent.com/a27bb88c89f9c450da561b4073e694a280af914046264e7a83dff5dab8142af9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d312e322e302d626c7565)](https://packagist.org/packages/hermes/dependencies)
- Larastan Larastan [![Latest Stable Version](https://camo.githubusercontent.com/3369ce909bcdef4de61b3254b6d9649515c8d7c00cfe86004f9b097f440b6948/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d76322e31312e322d626c7565)](https://packagist.org/packages/larastan/larastan)
- Orchestra Testbench [![Latest Stable Version](https://camo.githubusercontent.com/143d9acad5a2d13bacff50849fa27508a359f586690b5c4b7ded1da79e846b37/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d76392e31362e302d626c7565)](https://packagist.org/packages/orchestra/testbench)
- Pestphp Pest [![Latest Stable Version](https://camo.githubusercontent.com/bf4211afb0ddd5ed31b88d07f2dbec47d9a08cb532296a6160049cd331279dae/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737461626c652d76332e382e342d626c7565)](https://packagist.org/packages/pestphp/pest)

Testing ✅
---------

[](#testing-)

```
composer test
```

Problems? 🚨
-----------

[](#problems-)

Let me know about yours by [opening an issue](https://github.com/gboquizosanchez/screenscraper/issues/new)!

Credits 🧑‍💻
-----------

[](#credits-‍)

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

License 📄
---------

[](#license-)

MIT License (MIT). See [License File](LICENSE.md).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance86

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

72d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e360fba0cbca71392811fad1046d47397298adf9a191090e62eeeeab864e21d?d=identicon)[gboquizosanchez](/maintainers/gboquizosanchez)

---

Top Contributors

[![gboquizosanchez](https://avatars.githubusercontent.com/u/20032391?v=4)](https://github.com/gboquizosanchez "gboquizosanchez (4 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)

153107.2k2](/packages/moe-mizrak-laravel-openrouter)[gtmassey/laravel-analytics

Create and run Google Analytics Data API queries in Laravel

3868.4k](/packages/gtmassey-laravel-analytics)[helgesverre/mistral

Laravel Client for the Mistral.ai API

5213.5k1](/packages/helgesverre-mistral)[wallacemartinss/filament-whatsapp-conector

Filament plugin for WhatsApp integration with Evolution API v2

641.4k10](/packages/wallacemartinss-filament-whatsapp-conector)[deniskorbakov/laravel-data-scribe

A Scribe Plugin to generate API doc from spatie/laravel-data

124.3k](/packages/deniskorbakov-laravel-data-scribe)

PHPackages © 2026

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