PHPackages hotstream/laravel-tmdb - 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. hotstream/laravel-tmdb ActiveLibrary[API Development](/categories/api) hotstream/laravel-tmdb ====================== Simple integration with TMDB ( The Movie Database ) API to retrieve their data. 153PHP Since Apr 2Pushed 3y agoCompare [ Source](https://github.com/hotstream-project/laravel-tmdb)[ Packagist](https://packagist.org/packages/hotstream/laravel-tmdb)[ RSS](/packages/hotstream-laravel-tmdb/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) ⚡⚡⚡ Laravel Tmdb ================ [](#-laravel-tmdb) Simple integration with TMDB ( The Movie Database ) API to retrieve their data. [![Laravel media removable](logo.png)](logo.png) Table of contents ----------------- [](#table-of-contents) - [⚡⚡⚡ Laravel Tmdb](#-laravel-tmdb) - [Table of contents](#table-of-contents) - [Setup](#setup) - [Installation](#installation) - [Publish](#publish) - [Instructions](#instructions) - [Certifications](#certifications) - [Get Movie Certifications](#get-movie-certifications) - [Get TV Certifications](#get-tv-certifications) - [Changes](#changes) - [Get Movie Change List](#get-movie-change-list) - [Get TV Change List](#get-tv-change-list) - [Get Person Change List](#get-person-change-list) - [Collections](#collections) - [Get Details](#get-details) - [Get Images](#get-images) - [Get Transactions](#get-transactions) - [Companies](#companies) - [Get Details](#get-details-1) - [Get Alternative Names](#get-alternative-names) - [Get Images](#get-images-1) - [Configuration](#configuration) - [Get API Configuration](#get-api-configuration) - [Get Countries](#get-countries) - [Get Jobs](#get-jobs) - [Get Languages](#get-languages) - [Get Primary Translations](#get-primary-translations) - [Get Timezones](#get-timezones) - [Credits](#credits) - [Get Details](#get-details-2) - [Discover](#discover) - [Movie Discover](#movie-discover) - [TV Discover](#tv-discover) - [Genres](#genres) - [Get Movie List](#get-movie-list) - [Get TV List](#get-tv-list) - [Lists](#lists) - [Get Details](#get-details-3) - [Check Item Status](#check-item-status) - [Movies](#movies) - [Get Details](#get-details-4) - [Get Alternative Titles](#get-alternative-titles) - [Get Changes](#get-changes) - [Get Credits](#get-credits) - [Get External IDs](#get-external-ids) - [Get Images](#get-images-2) - [Get Keywords](#get-keywords) - [Get Lists](#get-lists) - [Get Recommendations](#get-recommendations) - [Get Release Dates](#get-release-dates) - [Get Reviews](#get-reviews) - [Get Similar Movies](#get-similar-movies) - [Get Translations](#get-translations) - [Get Videos](#get-videos) - [Get Watch Provider](#get-watch-provider) - [Get Latest](#get-latest) - [Get Now Playing](#get-now-playing) - [Get Popular](#get-popular) - [Get Top Rated](#get-top-rated) - [Get Upcoming](#get-upcoming) - [Networks](#networks) - [Get Details](#get-details-5) - [Get Alternative Names](#get-alternative-names-1) - [Get Images](#get-images-3) - [Trending](#trending) - [Get Trending](#get-trending) - [People](#people) - [Get Details](#get-details-6) - [Get Changes](#get-changes-1) - [Get Movie Credits](#get-movie-credits) - [Get TV Credits](#get-tv-credits) - [Get Combined Credits](#get-combined-credits) - [Get External IDs](#get-external-ids-1) - [Get Images](#get-images-4) - [Get Tagged Images](#get-tagged-images) - [Get Translations](#get-translations-1) - [Get Latest](#get-latest-1) - [Get Popular](#get-popular-1) - [Get Watch Providers](#get-watch-providers) - [Reviews](#reviews) - [Get Details](#get-details-7) - [Search](#search) - [Search Companies](#search-companies) - [Search Collections](#search-collections) - [Search Keywords](#search-keywords) - [Search Movies](#search-movies) - [multi Search](#multi-search) - [Search People](#search-people) - [Search TV Show](#search-tv-show) - [TV](#tv) - [Get Details](#get-details-8) - [Get Aggregate Credits](#get-aggregate-credits) - [Get Alternative Names](#get-alternative-names-2) - [Get Changes](#get-changes-2) - [Get Content Ratings](#get-content-ratings) - [Get Credits](#get-credits-1) - [Get Episode Groups](#get-episode-groups) - [Get External IDs](#get-external-ids-2) - [Get Images](#get-images-5) - [Get Keywords](#get-keywords-1) - [Get Recommendations](#get-recommendations-1) - [Get Reviews](#get-reviews-1) - [Get Screened Theatrically](#get-screened-theatrically) - [Get Similar TV Shows](#get-similar-tv-shows) - [Get Translations](#get-translations-2) - [Get Videos](#get-videos-1) - [Get latest](#get-latest-2) - [Get TV Airing Today](#get-tv-airing-today) - [Get On The Air](#get-on-the-air) - [Get Popular](#get-popular-2) - [Get Top Rated](#get-top-rated-1) - [TV Seasons](#tv-seasons) - [Get Details](#get-details-9) - [Get Aggregate Credits](#get-aggregate-credits-1) - [Get Changes](#get-changes-3) - [Get Credits](#get-credits-2) - [Get External IDs](#get-external-ids-3) - [Get Images](#get-images-6) - [Get Transactions](#get-transactions-1) - [Get Videos](#get-videos-2) - [TV Episode](#tv-episode) - [Get Details](#get-details-10) - [Get Changes](#get-changes-4) - [Get Credits](#get-credits-3) - [Get External IDs](#get-external-ids-4) - [Get Images](#get-images-7) - [Get Transactions](#get-transactions-2) - [Get Videos](#get-videos-3) - [Watch Providers](#watch-providers) - [Get Available Regions](#get-available-regions) - [Get Movie Providers](#get-movie-providers) - [Get TV Providers](#get-tv-providers) - [Options](#options) - [Page](#page) - [Append To Response](#append-to-response) - [Query](#query) - [Testing](#testing) - [License](#license) Setup ----- [](#setup) ### Installation [](#installation) To install this package through composer run the following command in the terminal ``` composer require Hotstream/laravel-tmdb ``` ### Publish [](#publish) You have to publish config file with this artisan command: ``` php artisan vendor:publish --provider="Hotstream\Tmdb\TmdbServiceProvider" ``` - File `tmdb.php` will be publish in `config` folder after that. - Then you have to put your tmdb api key in your `env` file like this `TMDB_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`. - If the returned data from the API should be in another language, set the TMDB\_LANGUAGE key in your `env`, eg. like this: `TMDB_LANGUAGE=da`. Instructions ------------ [](#instructions) - You can use tmdb api and get information your want, first take a quick look at [official api page](https://developers.themoviedb.org/3/getting-started). - For all next API requests you have to use Tmdb facade ``` use Hotstream\Tmdb\Facades\Tmdb; ``` - Every request have it's own information link, you can know required parameters, returned array, different type of responses and optional query string and we take about this in [options](#options) section ### Certifications [](#certifications) #### Get Movie Certifications [](#get-movie-certifications) ``` $tmdb = Tmdb::certifications()->movieCertifications()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/certifications/get-movie-certifications). #### Get TV Certifications [](#get-tv-certifications) ``` $tmdb = Tmdb::certifications()->tvCertifications()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/certifications/get-tv-certifications). ### Changes [](#changes) #### Get Movie Change List [](#get-movie-change-list) ``` $tmdb = Tmdb::changes()->movieChangeList()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/changes/get-movie-change-list). #### Get TV Change List [](#get-tv-change-list) ``` $tmdb = Tmdb::changes()->tvChangeList()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/changes/get-tv-change-list). #### Get Person Change List [](#get-person-change-list) ``` $tmdb = Tmdb::changes()->personChangeList()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/changes/get-person-change-list). ### Collections [](#collections) #### Get Details [](#get-details) ``` $tmdb = Tmdb::collections()->details($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/collections/get-collection-details). #### Get Images [](#get-images) ``` $tmdb = Tmdb::collections()->images($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/collections/get-collection-images). #### Get Transactions [](#get-transactions) ``` $tmdb = Tmdb::collections()->transactions($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/collections/get-collection-translations). ### Companies [](#companies) #### Get Details [](#get-details-1) ``` $tmdb = Tmdb::companies()->details($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/companies/get-company-details). #### Get Alternative Names [](#get-alternative-names) ``` $tmdb = Tmdb::companies()->alternativeNames($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/companies/get-company-alternative-names). #### Get Images [](#get-images-1) ``` $tmdb = Tmdb::companies()->images($collectionId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/companies/get-company-images). ### Configuration [](#configuration) #### Get API Configuration [](#get-api-configuration) ``` $tmdb = Tmdb::configuration()->apiConfiguration()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-api-configuration). #### Get Countries [](#get-countries) ``` $tmdb = Tmdb::configuration()->countries()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-countries). #### Get Jobs [](#get-jobs) ``` $tmdb = Tmdb::configuration()->jobs()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-jobs). #### Get Languages [](#get-languages) ``` $tmdb = Tmdb::configuration()->languages()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-languages). #### Get Primary Translations [](#get-primary-translations) ``` $tmdb = Tmdb::configuration()->primaryTranslations()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-primary-translations). #### Get Timezones [](#get-timezones) ``` $tmdb = Tmdb::configuration()->timezones()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-timezones). ### Credits [](#credits) #### Get Details [](#get-details-2) ``` $tmdb = Tmdb::credits()->details($creditId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/configuration/get-credit-details). ### Discover [](#discover) #### Movie Discover [](#movie-discover) ``` $tmdb = Tmdb::discover()->movieDiscover()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/discover/movie-discover). #### TV Discover [](#tv-discover) ``` $tmdb = Tmdb::discover()->tvDiscover()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/discover/tv-discover). ### Genres [](#genres) #### Get Movie List [](#get-movie-list) ``` $tmdb = Tmdb::genres()->movieList()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/genres/get-movie-list). #### Get TV List [](#get-tv-list) ``` $tmdb = Tmdb::genres()->tvList()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/genres/get-tv-list). ### Lists [](#lists) #### Get Details [](#get-details-3) ``` $tmdb = Tmdb::lists()->details($listId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/lists/get-list-details). #### Check Item Status [](#check-item-status) ``` $tmdb = Tmdb::lists()->itemStatus($listId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/lists/check-item-status). ### Movies [](#movies) #### Get Details [](#get-details-4) ``` $tmdb = Tmdb::movies()->details($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-details). #### Get Alternative Titles [](#get-alternative-titles) ``` $tmdb = Tmdb::movies()->alternativeTitles($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-alternative-titles). #### Get Changes [](#get-changes) ``` $tmdb = Tmdb::movies()->changes($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-changes). #### Get Credits [](#get-credits) ``` $tmdb = Tmdb::movies()->credits($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-credits). #### Get External IDs [](#get-external-ids) ``` $tmdb = Tmdb::movies()->externalIds($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-external-ids). #### Get Images [](#get-images-2) ``` $tmdb = Tmdb::movies()->images($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-images). #### Get Keywords [](#get-keywords) ``` $tmdb = Tmdb::movies()->keywords($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-keywords). #### Get Lists [](#get-lists) ``` $tmdb = Tmdb::movies()->lists($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-lists). #### Get Recommendations [](#get-recommendations) ``` $tmdb = Tmdb::movies()->recommendations($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-recommendations). #### Get Release Dates [](#get-release-dates) ``` $tmdb = Tmdb::movies()->releaseDates($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-release-dates). #### Get Reviews [](#get-reviews) ``` $tmdb = Tmdb::movies()->reviews($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-reviews). #### Get Similar Movies [](#get-similar-movies) ``` $tmdb = Tmdb::movies()->similar($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-similar-movies). #### Get Translations [](#get-translations) ``` $tmdb = Tmdb::movies()->translations($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-translations). #### Get Videos [](#get-videos) ``` $tmdb = Tmdb::movies()->videos($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-videos). #### Get Watch Provider [](#get-watch-provider) ``` $tmdb = Tmdb::movies()->watchProviders($movieId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-watch-providers). #### Get Latest [](#get-latest) ``` $tmdb = Tmdb::movies()->latest()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-movie-latest). #### Get Now Playing [](#get-now-playing) ``` $tmdb = Tmdb::movies()->nowPlaying()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-now-playing). #### Get Popular [](#get-popular) ``` $tmdb = Tmdb::movies()->popular()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-popular-movies). #### Get Top Rated [](#get-top-rated) ``` $tmdb = Tmdb::movies()->topRated()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-top-rated-movies). #### Get Upcoming [](#get-upcoming) ``` $tmdb = Tmdb::movies()->upcoming()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/movies/get-upcoming). ### Networks [](#networks) #### Get Details [](#get-details-5) ``` $tmdb = Tmdb::networks()->details($networkId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/networks/get-network-details). #### Get Alternative Names [](#get-alternative-names-1) ``` $tmdb = Tmdb::networks()->alternativeNames($networkId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/networks/get-network-alternative-names). #### Get Images [](#get-images-3) ``` $tmdb = Tmdb::networks()->images($networkId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/networks/get-network-images). ### Trending [](#trending) #### Get Trending [](#get-trending) ``` $tmdb = Tmdb::trending()->trending($mediaType, $timeWindow)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/trending/get-trending). ### People [](#people) #### Get Details [](#get-details-6) ``` $tmdb = Tmdb::people()->details($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-details). #### Get Changes [](#get-changes-1) ``` $tmdb = Tmdb::people()->changes($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-changes). #### Get Movie Credits [](#get-movie-credits) ``` $tmdb = Tmdb::people()->movieCredits($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-movie-credits). #### Get TV Credits [](#get-tv-credits) ``` $tmdb = Tmdb::people()->tvCredits($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-tv-credits). #### Get Combined Credits [](#get-combined-credits) ``` $tmdb = Tmdb::people()->combinedCredits($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-combined-credits). #### Get External IDs [](#get-external-ids-1) ``` $tmdb = Tmdb::people()->externalIds($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-external-ids). #### Get Images [](#get-images-4) ``` $tmdb = Tmdb::people()->images($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-images). #### Get Tagged Images [](#get-tagged-images) ``` $tmdb = Tmdb::people()->taggedImages($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-tagged-images). #### Get Translations [](#get-translations-1) ``` $tmdb = Tmdb::people()->translations($personId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-person-translations). #### Get Latest [](#get-latest-1) ``` $tmdb = Tmdb::people()->latest()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-latest-person). #### Get Popular [](#get-popular-1) ``` $tmdb = Tmdb::people()->popular()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-popular-people). #### Get Watch Providers [](#get-watch-providers) ``` $tmdb = Tmdb::people()->popular()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-popular-people). ### Reviews [](#reviews) #### Get Details [](#get-details-7) ``` $tmdb = Tmdb::reviews()->details($reviewId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/people/get-reviews-details). ### Search [](#search) - Query option is required for this query and you put the search parameter instead of `$query` variable. - For more [Information](#query) #### Search Companies [](#search-companies) ``` $tmdb = Tmdb::search()->companies()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-companies). #### Search Collections [](#search-collections) ``` $tmdb = Tmdb::search()->collections()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-collections). #### Search Keywords [](#search-keywords) ``` $tmdb = Tmdb::search()->keywords()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-keywords). #### Search Movies [](#search-movies) ``` $tmdb = Tmdb::search()->movies()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-movies). #### multi Search [](#multi-search) ``` $tmdb = Tmdb::search()->multi()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/multi-search). #### Search People [](#search-people) ``` $tmdb = Tmdb::search()->people()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-people). #### Search TV Show [](#search-tv-show) ``` $tmdb = Tmdb::search()->tvShows()->query($query)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/search/search-tv-shows). ### TV [](#tv) #### Get Details [](#get-details-8) ``` $tmdb = Tmdb::tv()->details($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-translations). #### Get Aggregate Credits [](#get-aggregate-credits) ``` $tmdb = Tmdb::tv()->aggregateCredits($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-aggregate-credits). #### Get Alternative Names [](#get-alternative-names-2) ``` $tmdb = Tmdb::tv()->alternativeTitles($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-alternative-titles). #### Get Changes [](#get-changes-2) ``` $tmdb = Tmdb::tv()->changes($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-changes). #### Get Content Ratings [](#get-content-ratings) ``` $tmdb = Tmdb::tv()->contentRatings($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-content-ratings). #### Get Credits [](#get-credits-1) ``` $tmdb = Tmdb::tv()->credits($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-credits). #### Get Episode Groups [](#get-episode-groups) ``` $tmdb = Tmdb::tv()->episodeGroups($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-episode-groups). #### Get External IDs [](#get-external-ids-2) ``` $tmdb = Tmdb::tv()->externalIds($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-external-ids). #### Get Images [](#get-images-5) ``` $tmdb = Tmdb::tv()->images($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-images). #### Get Keywords [](#get-keywords-1) ``` $tmdb = Tmdb::tv()->keywords($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-keywords). #### Get Recommendations [](#get-recommendations-1) ``` $tmdb = Tmdb::tv()->recommendations($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-recommendations). #### Get Reviews [](#get-reviews-1) ``` $tmdb = Tmdb::tv()->reviews($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-reviews). #### Get Screened Theatrically [](#get-screened-theatrically) ``` $tmdb = Tmdb::tv()->screenedTheatrically($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-screened-theatrically). #### Get Similar TV Shows [](#get-similar-tv-shows) ``` $tmdb = Tmdb::tv()->similar($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-similar-tv-shows). #### Get Translations [](#get-translations-2) ``` $tmdb = Tmdb::tv()->translations($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-translations). #### Get Videos [](#get-videos-1) ``` $tmdb = Tmdb::tv()->watchProviders($tvId)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-watch-providers). #### Get latest [](#get-latest-2) ``` $tmdb = Tmdb::tv()->latest()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-latest-tv). #### Get TV Airing Today [](#get-tv-airing-today) ``` $tmdb = Tmdb::tv()->airingToday()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-airing-today). #### Get On The Air [](#get-on-the-air) ``` $tmdb = Tmdb::tv()->onTheAir()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-tv-on-the-air). #### Get Popular [](#get-popular-2) ``` $tmdb = Tmdb::tv()->popular()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-popular-tv-shows). #### Get Top Rated [](#get-top-rated-1) ``` $tmdb = Tmdb::tv()->topRated()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv/get-top-rated-tv). ### TV Seasons [](#tv-seasons) #### Get Details [](#get-details-9) ``` $tmdb = Tmdb::tvSeasons()->details($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-details). #### Get Aggregate Credits [](#get-aggregate-credits-1) ``` $tmdb = Tmdb::tvSeasons()->aggregateCredits($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-aggregate-credits). #### Get Changes [](#get-changes-3) ``` $tmdb = Tmdb::tvSeasons()->changes($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-changes). #### Get Credits [](#get-credits-2) ``` $tmdb = Tmdb::tvSeasons()->credits($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-credits). #### Get External IDs [](#get-external-ids-3) ``` $tmdb = Tmdb::tvSeasons()->externalIds($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-external-ids). #### Get Images [](#get-images-6) ``` $tmdb = Tmdb::tvSeasons()->images($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-images). #### Get Transactions [](#get-transactions-1) ``` $tmdb = Tmdb::tvSeasons()->transactions($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-transactions). #### Get Videos [](#get-videos-2) ``` $tmdb = Tmdb::tvSeasons()->videos($tvId, $seasonNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-seasons/get-tv-season-videos). ### TV Episode [](#tv-episode) #### Get Details [](#get-details-10) ``` $tmdb = Tmdb::tvEpisodes()->details($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-details). #### Get Changes [](#get-changes-4) ``` $tmdb = Tmdb::tvEpisodes()->changes($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-changes). #### Get Credits [](#get-credits-3) ``` $tmdb = Tmdb::tvEpisodes()->credits($episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-credits). #### Get External IDs [](#get-external-ids-4) ``` $tmdb = Tmdb::tvEpisodes()->externalIds($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-external-ids). #### Get Images [](#get-images-7) ``` $tmdb = Tmdb::tvEpisodes()->images($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-images). #### Get Transactions [](#get-transactions-2) ``` $tmdb = Tmdb::tvEpisodes()->transactions($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-transactions). #### Get Videos [](#get-videos-3) ``` $tmdb = Tmdb::tvEpisodes()->videos($tvId, $seasonNumber, $episodeNumber)->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/tv-episodes/get-tv-episode-videos). ### Watch Providers [](#watch-providers) #### Get Available Regions [](#get-available-regions) ``` $tmdb = Tmdb::watchProviders()->availableRegions()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/watch-providers/get-available-regions). #### Get Movie Providers [](#get-movie-providers) ``` $tmdb = Tmdb::watchProviders()->movieProviders()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/watch-providers/get-movie-providers). #### Get TV Providers [](#get-tv-providers) ``` $tmdb = Tmdb::watchProviders()->tvProviders()->get(); // return array ``` - For more [information](https://developers.themoviedb.org/3/watch-providers/get-tv-providers). Options ------- [](#options) - tmdb api provides some options in some requests to provide more flexibility during request, and we add some of them here. - You will find supported options with explanation of every option we have in **Query String** section in every information page Like the one [here](https://developers.themoviedb.org/3/movies/get-popular-movies) and as you can see languages, page, and region supported by tmdb. [![options](options.png)](options.png) - We don't support all options yet but will add more by time. - You have to read the of tmdb carefully to avoid using unsupported option. - Here is some options which supported in this packages with explanation. ### Page [](#page) - If you want to get most popular movies from tmdb api you will get only 20 records will you can get about 800 record so instead or returning the whole records they give you only first 20 records and you can get the next 20 by using page option. - So instead of using the request like that ``` $tmdb = Tmdb::movies()->popular()->get(); // return array ``` and that will return the first page, you can specify the page you wanted to get for example if you want to get second page you will write the request like that. ``` $tmdb = Tmdb::movies()->popular()->page(2)->get(); // return array ``` ### Append To Response [](#append-to-response) - The option equivalent of query parameter append\_to\_response, for more [Information](https://developers.themoviedb.org/3/getting-started/append-to-response) - This option can take multiple parameters like **videos, posters and casts**. - For example you can append more information about movie casts buy using this query. ``` $tmdb = Tmdb::movies()->details($movieId)->appendToResponse(['casts'])->get(); // return array ``` ### Query [](#query) - This option used when you want to use tmdb search. - For example if you want to search for tv show you have to get it by this way. ``` $tmdb = Tmdb::search()->tvShows()->query($query)->get(); ``` where `$query` is a string you want to search for and it will be a tv show in this example. Testing ------- [](#testing) To run test use this command `vendor/bin/phpunit` License ------- [](#license) This package is a free software distributed under the terms of the MIT license. ### Health Score 16 — LowBetter than 5% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community9 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor1 Top contributor holds 78.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. ### Community Maintainers ![](https://www.gravatar.com/avatar/bc2cfb936a2880904f7044e8cb16e671aeabff1468eb7b31c7a2a577bad12237?d=identicon)[iamgpe](/maintainers/iamgpe) --- Top Contributors [![moelkomy](https://avatars.githubusercontent.com/u/70802292?v=4)](https://github.com/moelkomy "moelkomy (18 commits)")[![glomepe](https://avatars.githubusercontent.com/u/46260837?v=4)](https://github.com/glomepe "glomepe (3 commits)")[![ClausMunch](https://avatars.githubusercontent.com/u/701248?v=4)](https://github.com/ClausMunch "ClausMunch (2 commits)") ### Embed Badge ![Health badge](/badges/hotstream-laravel-tmdb/health.svg) ``` [![Health](https://phpackages.com/badges/hotstream-laravel-tmdb/health.svg)](https://phpackages.com/packages/hotstream-laravel-tmdb) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)