Skip to content
A Java wrapper around API v3 using retrofit2.
Branch: master
Clone or download

Pull requests (e.g. support for more API endpoints, bug fixes) are welcome!


A Java wrapper around the TMDb v3 API using retrofit 2.


Available on Maven Central

Add the following dependency to your Gradle project:

implementation 'com.uwetrottmann.tmdb2:tmdb-java:2.0.3'

or your Maven project:


Use like any other retrofit2 based service. For example:

// Create an instance of the service you wish to use
// you should re-use these
Tmdb tmdb = new Tmdb(API_KEY);
MoviesService moviesService = tmdb.moviesService();
// Call any of the available endpoints
try {
    Response<Movie> response = moviesService
    if (response.isSuccessful()) {
        Movie movie = response.body();
        System.out.println(movie.title + " is awesome!");
} catch (Exception e) {
    // see execute() javadoc 

See test cases in src/test/ for more examples and the retrofit website for configuration options.


This library ships Java 8 bytecode. This requires Android Gradle Plugin 3.2.x or newer.

Use Proguard!

You likely will not use every method in this library, so it is probably useful to strip unused ones with Proguard. Just apply the Proguard rules for retrofit.


Created by Uwe Trottmann.

See full list of contributors.

Except where noted otherwise, released into the public domain. Do not just copy, make it better.

You can’t perform that action at this time.