PHPackages                             messerli90/igdb - 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. messerli90/igdb

ActiveLibrary[API Development](/categories/api)

messerli90/igdb
===============

Laravel PHP Facade/Wrapper for the IGDB API

1.0.0(8y ago)309.5k↓100%9[2 issues](https://github.com/messerli90/igdb/issues)[1 PRs](https://github.com/messerli90/igdb/pulls)MITPHPPHP &gt;=5.6.0CI failing

Since Jan 2Pushed 6y ago3 watchersCompare

[ Source](https://github.com/messerli90/igdb)[ Packagist](https://packagist.org/packages/messerli90/igdb)[ RSS](/packages/messerli90-igdb/feed)WikiDiscussions master Synced today

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

IGDB (Internet Game Database)
=============================

[](#igdb-internet-game-database)

[![Build Status](https://camo.githubusercontent.com/4b73ab36cfc4100fbb39bde8a55a3b0bab2765d12997a3959f5430225b3c198e/68747470733a2f2f7472617669732d63692e6f72672f6d65737365726c6939302f696764622e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/messerli90/igdb)[![Built For Laravel](https://camo.githubusercontent.com/5dc33dc453936987e8423b2e93ebdb1955ecc7187cc664824ca4a957aecb85c2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6275696c74253230666f722d6c61726176656c2d626c75652e737667)](http://laravel.com)[![License](https://camo.githubusercontent.com/6d95ffe9415ab1c9e76eb3825ce99dd60a84398a74c360b98c95e60eca6515f4/68747470733a2f2f706f7365722e707567782e6f72672f6d65737365726c6939302f696764622f6c6963656e7365)](https://packagist.org/packages/messerli90/igdb)[![Total Downloads](https://camo.githubusercontent.com/a1a4549a9be3b485223636aa4ad05e72b94ae6d70646f64bfd5cb1f9371d53e1/68747470733a2f2f706f7365722e707567782e6f72672f6d65737365726c6939302f696764622f646f776e6c6f616473)](https://packagist.org/packages/messerli90/igdb)

Introduction
------------

[](#introduction)

This packages provides a nice and easy wrapper around the [IGDB API](https://igdb.github.io/api/about/welcome/) for use in your Laravel application.

In order to use the IGDB API, you must have a account and key. You can register your app at .

Installation
------------

[](#installation)

Add `messerli90/igdb` to your `composer.json`.

```
"messerli90/igdb": "~1.0"

```

or

```
composer require messerli90/igdb
```

Run `composer update` to pull down the latest version of the package.

Now open up `app/config/app.php` and add the service provider to your `providers` array.

```
'providers' => array(
    Messerli90\IGDB\IGDBServiceProvider::class,
)
```

Optionally, add the facade to your `aliases` array

```
'IGDB' => \Messerli90\IGDB\Facades\IGDB::class,
```

Configuration
-------------

[](#configuration)

Add the `igdb` to your `config/services.php` array. Set cache to a number of minutes to cache responses.

```
'igdb' => [
    'key' => 'YOUR_IGDB_KEY',
    'url' => 'YOUR_IGDB_URL',
    'cache' => 0
]
```

Usage
-----

[](#usage)

```
// Get Game by ID
$game = IGDB::getGame(9630);

// Customize / limit the returned fields
$games = IGDB::getGame(9630, ['name', 'release_dates', 'esrb', 'genres'], $limit = 10, $offset = 0, $order = 'release_dates.date:desc');

// Search Games by name
$games = IGDB::searchGames('fallout');

// Get Character by ID
$character = IGDB::getCharacter(4534);

// Search Characters by name
$characters = IGDB::searchCharacters('fisher');

// Get upcoming releases
$releases = IGDB::getReleases($filters = ['filter[platform][eq]=48', 'filter[date][gt]=1500619813000], $fields = ['*'], $limit = 10, $offset = 0, $order = 'date:asc');

// Get Company by ID
$companies = IGDB::getCompany('ubisoft');

// Search Company by name
$company = IGDB::getCompany(7041);

// Get Franchise by ID
$franchise = IGDB::getFranchise(133);

// Search Franchise by name
$franchises = IGDB::searchFranchises('Harry Potter');

// Get Game Mode by Id
$game_mode = IGDB::getGameMode(1);

// Search Game Modes by name
$game_modes = IGDB::searchGameModes('Single Player');

// Get Genre by ID
$genre = IGDB::getGenre(15);

// Search Genres by name
$genres = IGDB::searchGenres('strategy');

// Get Keyword by ID
$keyword = IGDB::getKeyword(121);

// Search Keyword by name
$keywords = IGDB::searchKeywords('sandbox');

// Get Person by ID
$person = IGDB::getPerson(24354);

// Search People by name
$people = IGDB::searchPeople('Delaney');

// Get Platform by ID
$platform = IGDB::getPlatform(49);

// Search Platforms by name
$platforms = IGDB::searchPlatforms('xbox');

// Get Player Perspective by ID
$player_perspective = IGDB::getPlayerPerspective(7);

// Search Player Perspective by name
$player_perspectives = IGDB::searchPlayerPerspectives('Virtual');

// Get Pulse by ID
$pulse = IGDB::getPulse(20707);

// Fetch latest Pulses
$pulses = IGDB::fetchPulses();

// Get Collection / Series by ID
$collection = IGDB::getCollection(3);

// Search Collections / Series by name
$collections = IGDB::searchCollections('fallout');

// Get Theme by ID
$theme = IGDB::getTheme(39);

// Search Themes by name
$themes = IGDB::searchThemes('warfare');
```

Format of returned data
-----------------------

[](#format-of-returned-data)

The returned JSON data is decoded as a PHP object.

Run Unit Test
-------------

[](#run-unit-test)

If you have PHPUnit installed in your environment, run:

```
$ phpunit
```

IGDB API
--------

[](#igdb-api)

- [IGDB API Docs](https://igdb.github.io/api/about/welcome/)
- [Register application and obtain API key](https://api.igdb.com/)

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Michael Messerli](https://twitter.com/michaelmesserli)
- [k4kuz0](https://github.com/k4kuz0)

License
-------

[](#license)

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

###  Health Score

34

—

LowBetter than 78% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60% 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 ~215 days

Total

2

Last Release

3152d ago

Major Versions

v0.1-alpha → 1.0.02017-08-06

PHP version history (2 changes)v0.1-alphaPHP &gt;=5.3.0

1.0.0PHP &gt;=5.6.0

### Community

Maintainers

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

---

Top Contributors

[![messerli90](https://avatars.githubusercontent.com/u/3306651?v=4)](https://github.com/messerli90 "messerli90 (15 commits)")[![dbfx](https://avatars.githubusercontent.com/u/182394?v=4)](https://github.com/dbfx "dbfx (7 commits)")[![2gen](https://avatars.githubusercontent.com/u/2212403?v=4)](https://github.com/2gen "2gen (2 commits)")[![louis-marchant](https://avatars.githubusercontent.com/u/6428417?v=4)](https://github.com/louis-marchant "louis-marchant (1 commits)")

---

Tags

igdbigdb-apilaravellaravel-php-facadewrapperapilaraveligdbgamingmesserli90

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/messerli90-igdb/health.svg)

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

###  Alternatives

[jubaer/zoom-laravel

A comprehensive Zoom integration package for Laravel, providing easy-to-use API functionality to interact with the Zoom platform using PHP.

57102.7k](/packages/jubaer-zoom-laravel)[rakibdevs/openweather-laravel-api

Laravel package to connect https://openweathermap.org/ to get customized weather data for any location on the globe immediately

7646.6k](/packages/rakibdevs-openweather-laravel-api)[d-scribe/laraquick

A collection of classes to be extended/used in laravel applications for quick development

371.8k1](/packages/d-scribe-laraquick)

PHPackages © 2026

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