PHPackages adrenth/thetvdb2 - 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. adrenth/thetvdb2 AbandonedArchivedLibrary[API Development](/categories/api) adrenth/thetvdb2 ================ API v2 Client for thetvdb.com 6.2.2(1y ago)3571.3k↓37.2%19[1 issues](https://github.com/adrenth/thetvdb2/issues)[1 PRs](https://github.com/adrenth/thetvdb2/pulls)MITPHPPHP >=7.4 Since May 9Pushed 1y ago4 watchersCompare [ Source](https://github.com/adrenth/thetvdb2)[ Packagist](https://packagist.org/packages/adrenth/thetvdb2)[ Docs](https://github.com/adrenth/thetvdb2)[ RSS](/packages/adrenth-thetvdb2/feed)WikiDiscussions develop Synced 1mo ago READMEChangelog (4)Dependencies (4)Versions (25)Used By (0) adrenth/thetvdb2 ================ [](#adrenththetvdb2) This is an API client for the thetvdb.com website. It's using the RESTful API which you'll need to register for to use this package. API Key Registration -------------------- [](#api-key-registration) To use this PHP package, you need to request an API Key from the thetvdb.com website: . Please follow these guidelines: - If you will be using the API information in a commercial product or website, you must email and wait for authorization before using the API. However, you MAY use the API for development and testing before a public release. - If you have a publicly available program, you MUST inform your users of this website and request that they help contribute information and artwork if possible. - You MUST familiarize yourself with our data structure, which is detailed in the wiki documentation. - You MUST NOT perform more requests than are necessary for each user. This means no downloading all of our content (we'll provide the database if you need it). Play nice with our server. - You MUST NOT directly access our data without using the documented API methods. - You MUST keep the email address in your account information current and accurate in case we need to contact you regarding your key (we hate spam as much as anyone, so we'll never release your email address to anyone else). - Please feel free to contact us and request changes to our site and/or API. We'll happily consider all reasonable suggestions. *Source: thetvdb.com* Installation ------------ [](#installation) Install this package using composer: ``` $ composer require adrenth/thetvdb2 ``` Requirements ------------ [](#requirements) At least PHP 7.4 Documentation ------------- [](#documentation) The official API documentation can be found here: https://api.thetvdb.com/swagger. ### Authentication [](#authentication) ``` $client = new \Adrenth\Thetvdb\Client(); $client->setLanguage('nl'); // Obtain a token $token = $client->authentication()->login($apiKey, $username, $userKey); $client->setToken($token); // Or refresh the token $client->refreshToken(); ``` ### Extensions [](#extensions) The `Client` has a few extensions. A few usage examples are listed below: #### Authentication [](#authentication-1) ``` $client->authentication()->login($apiKey, $username, $userKey); $client->authentication()->refreshToken(); ``` #### Languages [](#languages) ``` $client->languages()->all(); $client->languages()->get($languageId); ``` #### Episodes [](#episodes) ``` $client->episodes()->get($episodeId); ``` #### Series [](#series) ``` $client->series()->get($seriesId); $client->series()->getActors($seriesId); $client->series()->getEpisodes($seriesId); $client->series()->getImages($seriesId); $client->series()->getLastModified($seriesId); ``` #### Search [](#search) ``` $client->search()->seriesByName('lost'); $client->search()->seriesByImdbId('tt2243973'); $client->search()->seriesByZap2itId('EP015679352'); ``` #### Updates [](#updates) Fetch a list of Series that have been recently updated: ``` $client->updates()->query($fromTime, $toTime); ``` #### Users [](#users) ``` $client->users()->get(); $client->users()->getFavorites(); $client->users()->addFavorite($identifier); $client->users()->removeFavorite($identifier); $client->users()->getRatings(); $client->users()->addRating($type, $itemId, $rating); $client->users()->updateRating($type, $itemId, $rating); $client->users()->removeRating($type, $itemId); ``` #### Movies [](#movies) ``` $client->movies()->get(78398); $client->movies()->getUpdates(); ``` ### Response data [](#response-data) Every response object has a `getData()` method which may contain a collection of objects. For example: ``` // Get all available languages $languageData = $client->languages()->all(); // Returns a LanguageData instance $languages = $languageData->getData()->all(); array:23 [▼ 0 => Language {#26 ▼ -values: array:4 [▼ "id" => 27 "abbreviation" => "zh" "name" => "中文" "englishName" => "Chinese" ] } 1 => Language {#19 ▶} 2 => Language {#30 ▶} 3 => Language {#21 ▶} // .. ]; ``` Contributing ------------ [](#contributing) Feel free to join us and create a stable version which is compatible with the brand new TheTVDB.com RESTful API. ### Health Score 45 — FairBetter than 93% of packages Maintenance31 Infrequent updates — may be unmaintained Popularity43 Moderate usage in the ecosystem Community19 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 64.6% 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 ~140 days Recently: every ~212 days Total 22 Last Release 708d ago Major Versions 1.0.5 → 2.0.02017-06-07 2.2.0 → 3.0.02019-12-01 3.0.0 → 4.0.02020-05-23 4.0.0 → 5.0.02020-11-30 5.1.3 → 6.0.02022-02-12 PHP version history (4 changes)1.0.0PHP >=5.5 2.0.0PHP >=7.1 2.1.0PHP ^7.1 6.0.0PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/c38e829966665f64fa8cbac286c5e6e381094646241a5a8489d1e84d1b29b31b?d=identicon)[adrenth](/maintainers/adrenth) --- Top Contributors [![adrenth](https://avatars.githubusercontent.com/u/5699988?v=4)](https://github.com/adrenth "adrenth (53 commits)")[![OskarStark](https://avatars.githubusercontent.com/u/995707?v=4)](https://github.com/OskarStark "OskarStark (22 commits)")[![koichirose](https://avatars.githubusercontent.com/u/545772?v=4)](https://github.com/koichirose "koichirose (3 commits)")[![Reapious](https://avatars.githubusercontent.com/u/9056474?v=4)](https://github.com/Reapious "Reapious (2 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![Phoenix09](https://avatars.githubusercontent.com/u/3220224?v=4)](https://github.com/Phoenix09 "Phoenix09 (1 commits)") --- Tags apiapi-clientthetvdbapilibrarythetvdb.comthetvdb ### Code Quality Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/adrenth-thetvdb2/health.svg) ``` [![Health](https://phpackages.com/badges/adrenth-thetvdb2/health.svg)](https://phpackages.com/packages/adrenth-thetvdb2) ``` ### Alternatives [checkout/checkout-sdk-php Checkout.com SDK for PHP 553.3M7](/packages/checkout-checkout-sdk-php)[smodav/mpesa M-Pesa API implementation 16363.7k1](/packages/smodav-mpesa)[ardakilic/mutlucell Mutlucell SMS API wrapper for sending sms text messages for Laravel 457.3k](/packages/ardakilic-mutlucell)[dariusiii/tmdb-laravel Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library. 1821.1k](/packages/dariusiii-tmdb-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)