PHPackages rewrewby/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. rewrewby/thetvdb2 ActiveLibrary[API Development](/categories/api) rewrewby/thetvdb2 ================= API v2 Client for thetvdb.com 1.0.4(9y ago)013MITPHPPHP >=5.5 Since May 9Pushed 9y ago1 watchersCompare [ Source](https://github.com/rewrewby/thetvdb2)[ Packagist](https://packagist.org/packages/rewrewby/thetvdb2)[ Docs](http://github.com/rewrewby/thetvdb2)[ RSS](/packages/rewrewby-thetvdb2/feed)WikiDiscussions develop Synced 3w ago READMEChangelog (1)Dependencies (5)Versions (7)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 ``` 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 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); //.. ``` ### 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) This is version 2.0 of the TheTVDB.com API client. Feel free to join us and create a stable version which is compatible with the brand new TheTVDB.com RESTful API. ### Health Score 26 — LowBetter than 41% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community9 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 50% 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 ~24 days Total 5 Last Release 3605d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/9310599?v=4)[REW](/maintainers/rewrewby)[@rewrewby](https://github.com/rewrewby) --- Top Contributors [![adrenth](https://avatars.githubusercontent.com/u/5699988?v=4)](https://github.com/adrenth "adrenth (2 commits)")[![rewrewby](https://avatars.githubusercontent.com/u/9310599?v=4)](https://github.com/rewrewby "rewrewby (2 commits)") --- Tags apilibrarythetvdb.comthetvdb ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/rewrewby-thetvdb2/health.svg) ``` [![Health](https://phpackages.com/badges/rewrewby-thetvdb2/health.svg)](https://phpackages.com/packages/rewrewby-thetvdb2) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M2.9k](/packages/craftcms-cms)[smodav/mpesa M-Pesa API implementation 16167.1k1](/packages/smodav-mpesa)[simplestats-io/laravel-client Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof. 5019.3k](/packages/simplestats-io-laravel-client)[files.com/files-php-sdk Files.com PHP SDK 2478.1k](/packages/filescom-files-php-sdk)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1348.1k1](/packages/jasara-php-amzn-selling-partner-api)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 252.5k](/packages/eslazarev-wildberries-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)