This library provides a java-wrapper around the JSON API provided by TMdB, which is an open database for movie and film content.

Just add it as dependency to your project. It's available via jcenter

<dependency>
    <groupId>info.movito</groupId>
    <artifactId>themoviedbapi</artifactId>
    <version>1.4</version>
</dependency>

Read the Set me up section first, if you haven't addded jcenter as a repository to your pom.xml yet.

Or just add it via gradle when developing for Android:

repositories {
    jcenter()
}

dependencies{
    compile group: 'info.movito', name: 'themoviedbapi', version:'1.4'
}

To get started you need a TMdB API key. With this you can instantiate info.movito.themoviedbapi.TmdbApi, which has getters for all subcategories of the API.

For instance to get a movie by ID, do the following:

TmdbMovies movies = new TmdbApi("<apikey>").getMovies();
MovieDb movie = movies.getMovie(5353, "en");

The wrapper implements all major parts of the JSON API as detailed out in the TMdB API documentation. However, as the latter is subject to constant change, feel welcome to point out missing bits by submitting a ticket. Or even better, just send us a pull request!

This project uses SLF4J to abstract the logging in the project. To use the logging in your own project you should add one of the provided adapter bindings.

The library was developed for Movito to interact with tmdb services. This library has been inspired by api-themoviedb but has been rewritten to provide a more open license, a more clean API and to expose more features of the TMDB json api.