{"id":13828400,"url":"https://github.com/messerli90/igdb","last_synced_at":"2025-04-15T11:55:06.100Z","repository":{"id":62527332,"uuid":"77823303","full_name":"messerli90/igdb","owner":"messerli90","description":"Laravel PHP Facade/Wrapper for the IGDB API","archived":false,"fork":false,"pushed_at":"2019-10-30T07:00:11.000Z","size":27,"stargazers_count":30,"open_issues_count":3,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T19:53:42.835Z","etag":null,"topics":["igdb","igdb-api","laravel","laravel-php-facade","wrapper"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/messerli90.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-02T09:36:31.000Z","updated_at":"2021-04-07T16:56:43.000Z","dependencies_parsed_at":"2022-11-02T10:32:00.718Z","dependency_job_id":null,"html_url":"https://github.com/messerli90/igdb","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messerli90%2Figdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messerli90%2Figdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messerli90%2Figdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/messerli90%2Figdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/messerli90","download_url":"https://codeload.github.com/messerli90/igdb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067775,"owners_count":21207395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["igdb","igdb-api","laravel","laravel-php-facade","wrapper"],"created_at":"2024-08-04T09:02:44.756Z","updated_at":"2025-04-15T11:55:06.075Z","avatar_url":"https://github.com/messerli90.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"IGDB (Internet Game Database)\n=========\n\n[![Build Status](https://travis-ci.org/messerli90/igdb.svg?branch=master)](https://travis-ci.org/messerli90/igdb)\n[![Built For Laravel](https://img.shields.io/badge/built%20for-laravel-blue.svg)](http://laravel.com)\n[![License](https://poser.pugx.org/messerli90/igdb/license)](https://packagist.org/packages/messerli90/igdb)\n[![Total Downloads](https://poser.pugx.org/messerli90/igdb/downloads)](https://packagist.org/packages/messerli90/igdb)\n\n## Introduction\nThis packages provides a nice and easy wrapper around the [IGDB API](https://igdb.github.io/api/about/welcome/) for use in your Laravel application.\n\nIn order to use the IGDB API, you must have a account and key. You can register your app at [https://api.igdb.com/](https://api.igdb.com/). \n\n## Installation\n\nAdd `messerli90/igdb` to your `composer.json`.\n```\n\"messerli90/igdb\": \"~1.0\"\n```\nor \n```bash\ncomposer require messerli90/igdb\n```\n\nRun `composer update` to pull down the latest version of the package.\n\nNow open up `app/config/app.php` and add the service provider to your `providers` array.\n\n```php\n'providers' =\u003e array(\n    Messerli90\\IGDB\\IGDBServiceProvider::class,\n)\n```\n\nOptionally, add the facade to your `aliases` array\n```php\n'IGDB' =\u003e \\Messerli90\\IGDB\\Facades\\IGDB::class,\n```\n\n## Configuration\n\nAdd the `igdb` to your `config/services.php` array. Set cache to a number of minutes to cache responses.\n```php\n'igdb' =\u003e [\n    'key' =\u003e 'YOUR_IGDB_KEY',\n    'url' =\u003e 'YOUR_IGDB_URL',\n    'cache' =\u003e 0\n]\n```\n\n## Usage\n\n```php\n// Get Game by ID\n$game = IGDB::getGame(9630);\n\n// Customize / limit the returned fields\n$games = IGDB::getGame(9630, ['name', 'release_dates', 'esrb', 'genres'], $limit = 10, $offset = 0, $order = 'release_dates.date:desc');\n\n// Search Games by name\n$games = IGDB::searchGames('fallout');\n\n// Get Character by ID\n$character = IGDB::getCharacter(4534);\n\n// Search Characters by name\n$characters = IGDB::searchCharacters('fisher');\n\n// Get upcoming releases\n$releases = IGDB::getReleases($filters = ['filter[platform][eq]=48', 'filter[date][gt]=1500619813000], $fields = ['*'], $limit = 10, $offset = 0, $order = 'date:asc');\n\n// Get Company by ID\n$companies = IGDB::getCompany('ubisoft');\n\n// Search Company by name\n$company = IGDB::getCompany(7041);\n\n// Get Franchise by ID\n$franchise = IGDB::getFranchise(133);\n\n// Search Franchise by name\n$franchises = IGDB::searchFranchises('Harry Potter');\n\n// Get Game Mode by Id\n$game_mode = IGDB::getGameMode(1);\n\n// Search Game Modes by name\n$game_modes = IGDB::searchGameModes('Single Player');\n\n// Get Genre by ID\n$genre = IGDB::getGenre(15);\n\n// Search Genres by name\n$genres = IGDB::searchGenres('strategy');\n\n// Get Keyword by ID\n$keyword = IGDB::getKeyword(121);\n\n// Search Keyword by name\n$keywords = IGDB::searchKeywords('sandbox');\n\n// Get Person by ID\n$person = IGDB::getPerson(24354);\n\n// Search People by name\n$people = IGDB::searchPeople('Delaney');\n\n// Get Platform by ID\n$platform = IGDB::getPlatform(49);\n\n// Search Platforms by name\n$platforms = IGDB::searchPlatforms('xbox');\n\n// Get Player Perspective by ID\n$player_perspective = IGDB::getPlayerPerspective(7);\n\n// Search Player Perspective by name\n$player_perspectives = IGDB::searchPlayerPerspectives('Virtual');\n\n// Get Pulse by ID\n$pulse = IGDB::getPulse(20707);\n\n// Fetch latest Pulses\n$pulses = IGDB::fetchPulses();\n\n// Get Collection / Series by ID\n$collection = IGDB::getCollection(3);\n\n// Search Collections / Series by name\n$collections = IGDB::searchCollections('fallout');\n\n// Get Theme by ID\n$theme = IGDB::getTheme(39);\n\n// Search Themes by name\n$themes = IGDB::searchThemes('warfare');\n\n```\n\n## Format of returned data\n\nThe returned JSON data is decoded as a PHP object.\n\n## Run Unit Test\n\nIf you have PHPUnit installed in your environment, run:\n\n```bash\n$ phpunit\n```\n\n## IGDB API\n\n- [IGDB API Docs](https://igdb.github.io/api/about/welcome/)\n- [Register application and obtain API key](https://api.igdb.com/)\n\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n## Credits\n\n- [Michael Messerli](https://twitter.com/michaelmesserli)\n- [k4kuz0](https://github.com/k4kuz0)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesserli90%2Figdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmesserli90%2Figdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmesserli90%2Figdb/lists"}