PHPackages                             buibr/tmdbapi - 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. buibr/tmdbapi

ActiveLibrary[API Development](/categories/api)

buibr/tmdbapi
=============

PHP wrapper for The Movie Data Base API version 3

0162PHP

Since Apr 24Pushed 7y ago1 watchersCompare

[ Source](https://github.com/buibr/tmdbapi)[ Packagist](https://packagist.org/packages/buibr/tmdbapi)[ RSS](/packages/buibr-tmdbapi/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Documentation
-------------

[](#documentation)

[![Join the chat at https://gitter.im/pixelead0/tmdb_v3-PHP-API-](https://camo.githubusercontent.com/abe08b740a4156153736f791393ec4da6619c4be73212e75769f52edacc0e2b5/68747470733a2f2f6261646765732e6769747465722e696d2f4a6f696e253230436861742e737667)](https://gitter.im/pixelead0/tmdb_v3-PHP-API-?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

TMDB API v3 PHP Library - wrapper to [API](http://help.themoviedb.org/kb/api/about-3) version 3 of [themoviedb.org](http://themoviedb.org).

For using this library maybe you should take a look at the full [Documentation](http://code.octal.es/php/tmdb-api/) of this project.

@package TMDB-V3-PHP-API
@author [Pixelead0](https://twitter.com/pixelead0) also on [Github](https://github.com/pixelead0)
@author [Alvaro Octal](https://twitter.com/Alvaro_Octal) also on [Github](https://github.com/Alvaroctal)
@author [Deso85](https://twitter.com/Cizero) also on [Github](https://github.com/deso85)
@date 02/04/2016
@version 0.5

CREDITS
-------

[](#credits)

Forked from a similar [project](https://github.com/glamorous/TMDb-PHP-API) by [Jonas De Smet](https://github.com/glamorous)

### CHANGE LOG

[](#change-log)

- \[18/06/2017\] v0.6

    - Implemented function for multiSearch
    - Added example for multiSearch
    - Fixed examples
- \[02/04/2016\] v0.5

    - Made a class for configuration to load external configs
    - Updated functions list
    - Changed a few functions to use config object
    - Changed package structure of the project
- \[01/04/2016\] v0.4

    - Added config file
    - Some code changes to use config file
    - Some formal corrections inside comments
    - (Hopefully) Corrected Versioning
- \[17/01/2015\] v0.3 - Upgraded by

    - Upgrade by [/Alvaroctal/TMDB-PHP-API](https://github.com/Alvaroctal/TMDB-PHP-API).
    - Some modifications and dedicated classes added.
- \[07/11/2012\] v0.2

    - Fixed issue #2 (Object created in class php file)
    - Added functions latestMovie, nowPlayingMovies (thank's to steffmeister)
- \[12/02/2012\] v0.1

    - This is the first version of the class without inline documentation or testing
    - Forked from [glamorous/TMDb-PHP-API](https://github.com/glamorous/TMDb-PHP-API)

### Requirements

[](#requirements)

- PHP 5.2.x or higher
- cURL
- TMDB API-key

How to use
----------

[](#how-to-use)

View examples

### Initialize the class

[](#initialize-the-class)

If you have a $conf array

```

```

If you have no $conf array it uses the default conf but you need to have an API Key

```

```

Movies
------

[](#movies)

### Search a Movie

[](#search-a-movie)

```

```

returns a [Season](http://code.octal.es/php/tmdb-api/class-Season.html) Object.

### Get a TVShow's Episode

[](#get-a-tvshows-episode)

You should take a look at the Episode class [Documentation](http://code.octal.es/php/tmdb-api/class-Episode.html) and see all the info you can get from a Episode Object.

```

```

returns a [Episode](http://code.octal.es/php/tmdb-api/class-Episode.html) Object.

Persons
-------

[](#persons)

### Search a Person

[](#search-a-person)

```

```

returns an array of [Person](http://code.octal.es/php/tmdb-api/class-Person.html) Objects.

### Get a Person

[](#get-a-person)

You should take a look at the Person class [Documentation](http://code.octal.es/php/tmdb-api/class-Person.html) and see all the info you can get from a Person Object.

```

```

returns a [Person](http://code.octal.es/php/tmdb-api/class-Person.html) Object.

### Get Person's Roles

[](#get-persons-roles)

You should take a look at the Role class [Documentation](http://code.octal.es/php/tmdb-api/class-Role.html) and see all the info you can get from a Role Object.

```

```

returns an array of [MovieRole](http://code.octal.es/php/tmdb-api/class-MovieRole.html) Objects.

```

```

returns an array of [TVShowRole](http://code.octal.es/php/tmdb-api/class-TVShowRole.html) Objects.

Collections
-----------

[](#collections)

### Search a Collection

[](#search-a-collection)

```

```

returns an array of [Collection](http://code.octal.es/php/tmdb-api/class-Collection.html) Objects.

### Get a Collection

[](#get-a-collection)

You should take a look at the Collection class [Documentation](http://code.octal.es/php/tmdb-api/class-Collection.html) and see all the info you can get from a Collection Object.

```

```

returns a [Collection](http://code.octal.es/php/tmdb-api/class-Collection.html) Object.

Companies
---------

[](#companies)

### Search a Company

[](#search-a-company)

```

```

returns an array of [Company](http://code.octal.es/php/tmdb-api/class-Company.html) Objects.

### Get a Company

[](#get-a-company)

You should take a look at the Company class [Documentation](http://code.octal.es/php/tmdb-api/class-Company.html) and see all the info you can get from a Company Object.

```

```

returns a [Company](http://code.octal.es/php/tmdb-api/class-Company.html) Object.

Issues/Bugs
-----------

[](#issuesbugs)

Bugs are expected, this is still under development, you can [report](https://github.com/Alvaroctal/TMDB-PHP-API/issues) them.

### TODO List

[](#todo-list)

- Empty :D, you can [propose](https://github.com/Alvaroctal/TMDB-PHP-API/issues) new functionalities.

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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/3f010dfc3a6587d208aa1d9c7bec81d58f21fbf9100b1fce35b5ae05b747d5e5?d=identicon)[buibr](/maintainers/buibr)

---

Top Contributors

[![pixelead0](https://avatars.githubusercontent.com/u/735873?v=4)](https://github.com/pixelead0 "pixelead0 (38 commits)")[![alvaro-octal](https://avatars.githubusercontent.com/u/4562922?v=4)](https://github.com/alvaro-octal "alvaro-octal (23 commits)")[![deso85](https://avatars.githubusercontent.com/u/18106134?v=4)](https://github.com/deso85 "deso85 (14 commits)")[![bogdanfinn](https://avatars.githubusercontent.com/u/17678241?v=4)](https://github.com/bogdanfinn "bogdanfinn (9 commits)")[![buibr](https://avatars.githubusercontent.com/u/13014527?v=4)](https://github.com/buibr "buibr (6 commits)")[![akeinhell](https://avatars.githubusercontent.com/u/1063877?v=4)](https://github.com/akeinhell "akeinhell (5 commits)")[![olivier-nolbert](https://avatars.githubusercontent.com/u/81619726?v=4)](https://github.com/olivier-nolbert "olivier-nolbert (4 commits)")[![mmapes](https://avatars.githubusercontent.com/u/246760?v=4)](https://github.com/mmapes "mmapes (1 commits)")[![tharok2090](https://avatars.githubusercontent.com/u/5459861?v=4)](https://github.com/tharok2090 "tharok2090 (1 commits)")[![tnsws](https://avatars.githubusercontent.com/u/4859598?v=4)](https://github.com/tnsws "tnsws (1 commits)")[![Dimitris-Ilias](https://avatars.githubusercontent.com/u/15652566?v=4)](https://github.com/Dimitris-Ilias "Dimitris-Ilias (1 commits)")[![djleven](https://avatars.githubusercontent.com/u/11492131?v=4)](https://github.com/djleven "djleven (1 commits)")[![gitter-badger](https://avatars.githubusercontent.com/u/8518239?v=4)](https://github.com/gitter-badger "gitter-badger (1 commits)")[![J-Ulian](https://avatars.githubusercontent.com/u/61200449?v=4)](https://github.com/J-Ulian "J-Ulian (1 commits)")[![KaeferD](https://avatars.githubusercontent.com/u/2751176?v=4)](https://github.com/KaeferD "KaeferD (1 commits)")[![MarcoGomesr](https://avatars.githubusercontent.com/u/1093768?v=4)](https://github.com/MarcoGomesr "MarcoGomesr (1 commits)")

### Embed Badge

![Health badge](/badges/buibr-tmdbapi/health.svg)

```
[![Health](https://phpackages.com/badges/buibr-tmdbapi/health.svg)](https://phpackages.com/packages/buibr-tmdbapi)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
