tmdb 2.0.0

The Movie Database (TMDb) API for Rust
Documentation

The Movie Database

The Movie Database

This is a wrapper around the TMDb API.

Usage

extern crate tmdb;

use tmdb::model::*;
use tmdb::themoviedb::*;

fn main() {
    let tmdb = TMDb { api_key: env!("TMDB_API_KEY"), language: "en" };

    let movies = tmdb.search()
        .title("Interstellar")
        .year(2014)
        .execute()
        .unwrap();

    let id = movies[0].id;
    
    let interstellar = tmdb.fetch()
        .id(id)
        .execute()
        .unwrap();

    println!("{:?}", interstellar);
}

Actions

Currently there are 3 actions available:

  • Searching
  • Fetching
  • Finding

Searching

You can search for movies by title and year.

let page = tmdb.search()
	.title("Bicentennial Man")
	.year(1999)
	.execute()
	.unwrap();

let movies = page.results;

Fetching

You can fetch a movie, when you know its ID. Then you get all the movie details.

let movie = tmdb.fetch()
	.id(157336)
	.execute()
	.unwrap();

When you don't have any movie ID, you can search for a movie and then easily fetch the full details.

let page = tmdb.search()
	.title("Bicentennial Man")
	.year(1999)
	.execute()
	.unwrap();
	
let movies = page.results;
let movie = movies[0].fetch(&tmdb).unwrap();

Furthermore you can request some more data with the append to response feature.

let movie = tmdb.fetch()
	.id(2277)
	.append_videos()
	.append_credits()
	.execute()
	.unwrap();

Finding

Finding a movie with an external ID is currently supported with IMDB IDs.

let find_result = tmdb.find()
	.imdb_id("tt0816692")
	.execute()
	.unwrap();

let movies = find_result.movie_results;

Acknowledgements

  • This lib is heavily inspired by omdb-rs

https://www.themoviedb.org/