PHPackages                             vfalies/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. vfalies/tmdb

ActiveLibrary[API Development](/categories/api)

vfalies/tmdb
============

A PHP Wrapper for The Internet Movie Database API

1.12(4y ago)222.3k6MITPHPPHP >= 7.1CI failing

Since Jun 2Pushed 4y ago3 watchersCompare

[ Source](https://github.com/vfalies/tmdb)[ Packagist](https://packagist.org/packages/vfalies/tmdb)[ Docs](https://vfac.fr/projects/tmdb)[ RSS](/packages/vfalies-tmdb/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (29)Used By (0)

Tmdb - PHP Wrapper for The Movie Database API V3
================================================

[](#tmdb---php-wrapper-for-the-movie-database-api-v3)

[![Latest Stable Version](https://camo.githubusercontent.com/80d647f801dd5ef7cdd0d02ce8698dabb63b7d24f8070be4cbbb6dd9b2d87351/68747470733a2f2f706f7365722e707567782e6f72672f7666616c6965732f746d64622f76657273696f6e)](https://packagist.org/packages/vfalies/tmdb) [![Build Status](https://camo.githubusercontent.com/7d12a1d2bfdb5e0e64c78f8a26b78cea6c907ed3bb80ccc667dd313d8dc357bc/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7666616c6965732f746d64622f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/vfalies/tmdb/build-status/master) [![Code Coverage](https://camo.githubusercontent.com/58cc2cd8665ac2f298242831ab514cd31e78b3840f0e132d9283bf3b3323e2f0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7666616c6965732f746d64622f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/vfalies/tmdb/?branch=master) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/2d5eb3f61ade16c1ec8d8855ab654251a758912289ce86907db2cb0d5026d6eb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7666616c6965732f746d64622f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/vfalies/tmdb/?branch=master) [![License](https://camo.githubusercontent.com/df1d1dc54b0e63d8ed15bb216b4f4a8d022ef7151c6394888f6970430649c579/68747470733a2f2f706f7365722e707567782e6f72672f7666616c6965732f746d64622f6c6963656e7365)](https://packagist.org/packages/vfalies/tmdb)

[![Packagist PHP Version Support](https://camo.githubusercontent.com/116e21eb8db2689118830e408422bbcfef82686689abe61dba1a374be4490609/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7666616c6965732f746d6462)](https://camo.githubusercontent.com/116e21eb8db2689118830e408422bbcfef82686689abe61dba1a374be4490609/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7666616c6965732f746d6462)[![Tested on PHP 7.1 to 8.0](https://camo.githubusercontent.com/869546590400bc0b8621f07f87ed3b27f5a953fb3b77dcf447afe959a7a99590/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465737465642532306f6e2d504850253230372e31253230253743253230372e32253230253743253230372e33253230253743253230372e34253230253743253230382e302532302d627269676874677265656e2e7376673f6d61784167653d32343139323030)](https://github.com/vfalies/tmdb/actions/workflows/php.yml)

Tmdb is a PHP wrapper for [The Movie Database](https://www.themoviedb.org/) API [V3](https://developers.themoviedb.org).

Table of contents
-----------------

[](#table-of-contents)

1. [Features](#features)
2. [Installation](#installation)
3. [Basic usage](#basic-usage)
4. [Usage](#usage)
    1. [Getting a TMDB instance](#getting-a-tmdb-instance)
    2. [Movie](#movie)
    3. [TV Show](#tv-show)
    4. [Collection](#collection)
    5. [People](#people)
    6. [Company](#company)
    7. [Find by an external ID](#find)
    8. [Authentication](#authentication)
    9. [Media Helper](#media-helper)
5. [Unit tests](#unit-tests)
6. [About](#about)

Features
--------------------------------------------

[](#features)

Features actualy supported :

- Search
    - Movie
    - TV Show
    - Collection
    - Company
- Getting informations
    - Movie
    - TV Show
    - Collection
    - Company
    - Genres
    - TV Network
- Account
    - Authentification
    - Movies / TV Shows rating
    - Movies / TV Shows favorites
    - Movies / TV Shows watchlist
- Media
- Genres
- Jobs
- Find
    - IMDb
    - TheTVDb
    - TVRage
    - Facebook
    - Twitter
    - Instagram

Installation
----------------------------------------------------

[](#installation)

### Requirements

[](#requirements)

- Tmdb works with PHP 7.1 and higher
- TheMovieDatabase API key

### Composer

[](#composer)

Install the lastest version with

```
$ composer require vfalies/tmdb
```

Basic Usage
--------------------------------------------------

[](#basic-usage)

```