PHPackages dawson/tvdb - 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. [Database & ORM](/categories/database) 4. / 5. dawson/tvdb ActiveLibrary[Database & ORM](/categories/database) dawson/tvdb =========== A package for searching the TVDB database with Laravel. 1.2.0(6y ago)101581MITPHPPHP >=5.6.4 Since Sep 18Pushed 6y ago1 watchersCompare [ Source](https://github.com/JoeDawson/tvdb)[ Packagist](https://packagist.org/packages/dawson/tvdb)[ RSS](/packages/dawson-tvdb/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (5)Dependencies (1)Versions (7)Used By (0) Laravel - TVDB Package ====================== [](#laravel---tvdb-package) A dedicated Laravel package for the [TVDB](http://thetvdb.com/) API. The documentation for this package isn't 100% at the moment as I'm still developing as I go along. So expect the documentation to improve shortly. Installation ------------ [](#installation) To install, use the following to pull the package in via Composer. ``` composer require dawson/tvdb ``` Now register the Service provider in `config/app.php` ``` 'providers' => [ ... Dawson\TVDB\TVDBServiceProvider::class, ], ``` And also add the alias to the same file. ``` 'aliases' => [ ... 'TVDB' => Dawson\TVDB\TVDBFacade::class, ], ``` Configuration ------------- [](#configuration) You now need to publish the `tvdb.php` config. ``` php artisan vendor:publish --provider="Dawson\TVDB\TVDBServiceProvider" ``` Now add the following environment variables to your `.env` file. You can obtain your **user key** and **api key** from your account on TVDB ``` TVDB_USERNAME= TVDB_USERKEY= TVDB_APIKEY= ``` Searching ========= [](#searching) To search for TV Series, do the following: Here's an example: ``` $results = TVDB::search('Walking Dead'); return $results; ``` Where `$results` is a JSON response from the TVDB API. Here's an example response. ``` { "data": [ { "aliases": [], "banner": "graphical/153021-g44.jpg", "firstAired": "2010-10-31", "id": 153021, "network": "AMC", "overview": "The world we knew is gone. An epidemic of apocalyptic proportions has swept the globe causing the dead to rise and feed on the living. In a matter of months society has crumbled. In a world ruled by the dead, we are forced to finally start living. Based on a comic book series of the same name by Robert Kirkman, this AMC project focuses on the world after a zombie apocalypse. The series follows a police officer, Rick Grimes, who wakes up from a coma to find the world ravaged with zombies. Looking for his family, he and a group of survivors attempt to battle against the zombies in order to stay alive.\r\n", "seriesName": "The Walking Dead", "status": "Continuing" }, { "aliases": [], "banner": "graphical/290853-g5.jpg", "firstAired": "2015-08-23", "id": 290853, "network": "AMC", "overview": "A horrifying zombiocalypse spin-off series from The Walking Dead, set in the same universe but starting at a far earlier time in Los Angeles. The show follows normal people learning to deal with the rapidly growing collapse of civilization, at the very beginning of a zombie outbreak.\r\n\r\nIn Los Angeles, a city where people come to escape, shield secrets, and bury their pasts, we follow this mysterious outbreak as it threatens to disrupt what little stability high school guidance counselor Madison Clark and English teacher Travis Manawa have managed to assemble. \r\n\r\nThe pressure of blending two families while dealing with resentful, escapist, and strung out children takes a back seat when society begins to break down. A forced evolution, and survival of the fittest takes hold, as our dysfunctional family finds they must either reinvent themselves or embrace their darker histories.", "seriesName": "Fear the Walking Dead", "status": "Continuing" } ] } ``` Series ====== [](#series) Using a series ID, you can also perform a lookup to fetch further information on a series. ``` $theWalkingDead = TVDB::series('153021')->get(); ``` The `get()` method will also return JSON. Here's an example response. ``` { "data": { "added": "2010-03-30 01:30:16", "addedBy": 76261, "airsDayOfWeek": "Sunday", "airsTime": "9:00 PM", "aliases": [], "banner": "graphical/153021-g44.jpg", "firstAired": "2010-10-31", "genre": [ "Action", "Drama", "Horror", "Suspense" ], "id": 153021, "imdbId": "tt1520211", "lastUpdated": 1474059455, "network": "AMC", "networkId": "", "overview": "The world we knew is gone. An epidemic of apocalyptic proportions has swept the globe causing the dead to rise and feed on the living. In a matter of months society has crumbled. In a world ruled by the dead, we are forced to finally start living. Based on a comic book series of the same name by Robert Kirkman, this AMC project focuses on the world after a zombie apocalypse. The series follows a police officer, Rick Grimes, who wakes up from a coma to find the world ravaged with zombies. Looking for his family, he and a group of survivors attempt to battle against the zombies in order to stay alive.\r\n", "rating": "TV-MA", "runtime": "50", "seriesId": "78582", "seriesName": "The Walking Dead", "siteRating": 9, "siteRatingCount": 1354, "status": "Continuing", "zap2itId": "EP01324002" } } ``` ### Actors [](#actors) You also have the ability to fetch actors from a series too. ``` $actors = TVDB::series('153021')->actors(); ``` ### Episodes [](#episodes) You can fetch a full list of episodes too. ``` $episodes = TVDB::series('153021')->episodes(); ``` Questions ========= [](#questions) Should you have any questions, please feel free to submit an issue. ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community11 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 83.3% 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 ~242 days Recently: every ~302 days Total 6 Last Release 2317d ago Major Versions 1.2.0 → 2.0-beta2020-01-10 PHP version history (2 changes)1.0.0PHP >=5.6.4 2.0-betaPHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/3fd48706b946f9a2e2790697d8701cdc166ab96085ed9d28057e77bb38b11f89?d=identicon)[joedawson](/maintainers/joedawson) --- Top Contributors [![joedawson](https://avatars.githubusercontent.com/u/1009696?v=4)](https://github.com/joedawson "joedawson (15 commits)")[![AnsellC](https://avatars.githubusercontent.com/u/2049714?v=4)](https://github.com/AnsellC "AnsellC (2 commits)")[![aaronflorey](https://avatars.githubusercontent.com/u/948073?v=4)](https://github.com/aaronflorey "aaronflorey (1 commits)") ### Embed Badge ![Health badge](/badges/dawson-tvdb/health.svg) ``` [![Health](https://phpackages.com/badges/dawson-tvdb/health.svg)](https://phpackages.com/packages/dawson-tvdb) ``` ### Alternatives [kreait/firebase-php Firebase Admin SDK 2.4k39.7M72](/packages/kreait-firebase-php)[tpetry/laravel-mysql-explain Get Visual MySQL EXPLAIN for Laravel. 264154.2k](/packages/tpetry-laravel-mysql-explain)[aternus/geonames-client GeoNames API Client 39215.5k2](/packages/aternus-geonames-client)[gearbox-solutions/eloquent-filemaker A package for getting FileMaker records as Eloquent models in Laravel 6454.8k2](/packages/gearbox-solutions-eloquent-filemaker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)