PHPackages denand/tvdb-v4-client - 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. denand/tvdb-v4-client ActiveLibrary[API Development](/categories/api) denand/tvdb-v4-client ===================== TVDB V4 API Client for PHP v1.5.0(9mo ago)01MITPHPPHP ^7.4|^8.0|^8.1|^8.2|^8.3|^8.4 Since Sep 10Pushed 9mo agoCompare [ Source](https://github.com/denand-team/tvdb-v4-client)[ Packagist](https://packagist.org/packages/denand/tvdb-v4-client)[ Docs](https://github.com/denand/tvdb-v4-client)[ RSS](/packages/denand-tvdb-v4-client/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (4)Versions (12)Used By (0) [![Latest Version on Packagist](https://camo.githubusercontent.com/984be228829529579c76df6f3a7e92de390452ea78ed0e7feac60a3fbfe68409/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64656e616e642f747664622d76342d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/denand/tvdb-v4-client)[![Total Downloads](https://camo.githubusercontent.com/96b07970c5a7bf057742b85abd8fc8f71c7ebe8a8afec03ff237c8177c434337/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64656e616e642f747664622d76342d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/denand/tvdb-v4-client)[![License](https://camo.githubusercontent.com/931a02af7e6b0be5a1628f67c84b9cc573723193af9846650f9e2c415f0dfff3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f64656e616e642f747664622d76342d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/denand/tvdb-v4-client) TVDB V4 Client for PHP/Laravel ============================== [](#tvdb-v4-client-for-phplaravel) A comprehensive PHP client for The TVDB V4 API, designed to work seamlessly with Laravel applications. This package provides easy access to The TVDB's extensive database of TV series, movies, and related metadata. ๐Ÿ“š Official Documentation ------------------------ [](#-official-documentation) - **[The TVDB V4 API Documentation](https://thetvdb.github.io/v4-api/)** - Complete API reference and endpoints - **[The TVDB API Information & Licensing](https://www.thetvdb.com/api-information)** - API pricing, licensing, and attribution requirements ๐Ÿš€ Features ---------- [](#-features) - **Full TVDB V4 API Support** - Access to all available endpoints - **Laravel Integration** - Seamless Laravel service provider and facade - **Extended Data Support** - Get comprehensive series, episode, and movie information - **Translation Support** - Multi-language content retrieval - **Search Functionality** - Powerful search capabilities across the database - **Type and Status Support** - Access to metadata types and statuses - **Laravel 10 Compatible** - Updated for the latest Laravel version ๐Ÿ“ฆ Installation -------------- [](#-installation) ### Via Composer [](#via-composer) You can install the package with Composer using Packagist: ``` composer require denand/tvdb-v4-client ``` ### Configuration [](#configuration) 1. **Publish the configuration file:** ``` php artisan vendor:publish --provider="DenAnd\TvdbV4Client\TvdbV4ClientServiceProvider" ``` 2. **Configure your TVDB API credentials in `config/tvdb-v4-client.php`:** ``` return [ 'api_key' => env('TVDB_API_KEY', ''), 'api_pin' => env('TVDB_API_PIN', ''), // Add other configuration options as needed ]; ``` 3. **Add your TVDB API credentials to your `.env` file:** ``` TVDB_API_KEY=your_api_key_here TVDB_API_PIN=your_api_pin_here ``` ๐Ÿ”ง Usage ------- [](#-usage) ### Basic Usage [](#basic-usage) ``` use DenAnd\TvdbV4Client\TvdbV4Client; $tvdb = new TvdbV4Client(); // Get extended data for a TV series $series = $tvdb->getSeries('269586'); // Get series translations $translations = $tvdb->getSeriesTranslations('269586', 'eng'); // Get series with full data (translations + extended data) $seriesFull = $tvdb->getSeriesFull('269586', 'eng'); // Search for series $search = $tvdb->search('Brooklyn Nine-Nine'); // Search and get extended data $seriesByName = $tvdb->getSeriesByName('Brooklyn Nine-Nine'); ``` ### Laravel Facade Usage [](#laravel-facade-usage) ``` use DenAnd\TvdbV4Client\Facades\TvdbV4Client; // Using the facade $series = TvdbV4Client::getSeries('269586'); $search = TvdbV4Client::search('Breaking Bad'); ``` ### Available Methods [](#available-methods) - `getSeries($id)` - Get extended series data - `getSeriesTranslations($id, $language)` - Get series translations - `getSeriesFull($id, $language)` - Get series with translations and extended data - `search($query)` - Search for series, movies, or people - `getSeriesByName($name)` - Search and get extended data by name - `getTypes()` - Get available types - `getStatuses()` - Get available statuses ๐Ÿงช Testing --------- [](#-testing) ``` composer test ``` ๐Ÿ“‹ Requirements -------------- [](#-requirements) - PHP 7.4 or higher - Laravel 8.0+ (for Laravel integration) - The TVDB API credentials ๐Ÿ”— API Documentation & Resources ----------------------------------- [](#-api-documentation--resources) - **[The TVDB V4 API Documentation](https://thetvdb.github.io/v4-api/)** - Complete API reference - **[The TVDB API Information](https://www.thetvdb.com/api-information)** - Licensing, pricing, and attribution requirements - **[The TVDB Website](https://www.thetvdb.com/)** - Main website and data contribution ๐Ÿ“„ Changelog ----------- [](#-changelog) Please see [CHANGELOG](CHANGELOG.md) for more information about recent changes. ๐Ÿค Contributing -------------- [](#-contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. ๐Ÿ“œ License --------- [](#-license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ๐Ÿ™ Attribution ------------- [](#-attribution) When using this package, please ensure you comply with The TVDB's attribution requirements. Display the following attribution to end users: > "Metadata provided by TheTVDB. Please consider adding missing information or subscribing." For more information about attribution requirements, visit [The TVDB API Information page](https://www.thetvdb.com/api-information). ๐Ÿ‘ฅ Credits --------- [](#-credits) - [DenAnd Team](https://github.com/denand-team) - Package development and maintenance - [The TVDB](https://www.thetvdb.com/) - API and data provider ### Health Score 39 โ€” LowBetter than 85% of packages Maintenance61 Regular maintenance activity Popularity1 Limited adoption so far Community8 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor1 Top contributor holds 88.5% 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 ~142 days Recently: every ~192 days Total 11 Last Release 277d ago Major Versions v0.1.1 โ†’ v1.0.02021-09-13 PHP version history (3 changes)v0.1.0PHP ^7.4|^8.0 v1.3.0PHP ^7.4|^8.0|^8.1 v1.4.0PHP ^7.4|^8.0|^8.1|^8.2|^8.3|^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/6807237a0b4b3f5dcf3338f79a8de0a1b8c6ed5dc1065a88a06dc730123f924e?d=identicon)[sytrus](/maintainers/sytrus) --- Top Contributors [![rwal127](https://avatars.githubusercontent.com/u/25417269?v=4)](https://github.com/rwal127 "rwal127 (23 commits)")[![bendbot](https://avatars.githubusercontent.com/u/25432041?v=4)](https://github.com/bendbot "bendbot (3 commits)") --- Tags denandtvdb-v4-client ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/denand-tvdb-v4-client/health.svg) ``` [![Health](https://phpackages.com/badges/denand-tvdb-v4-client/health.svg)](https://phpackages.com/packages/denand-tvdb-v4-client) ``` ### Alternatives [skagarwal/google-places-api Google Places Api 1913.0M8](/packages/skagarwal-google-places-api)[dcblogdev/laravel-microsoft-graph A Laravel Microsoft Graph API (Office365) package 168285.5k1](/packages/dcblogdev-laravel-microsoft-graph)[vluzrmos/slack-api Wrapper for Slack.com WEB API. 102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa M-Pesa API implementation 16363.7k1](/packages/smodav-mpesa)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[grantholle/powerschool-api A Laravel package to make interacting with PowerSchool less painful. 1715.6k1](/packages/grantholle-powerschool-api) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)