node package manager
Stop writing boring code. Discover, share, and reuse within your team. Create a free org »

tmdb

TMDb

Travis build status Coveralls NPM version Canonical Code Style Twitter Follow

The Movie Database (TMDb) SDK.

Features

  • Automatic rate-throttling
  • Strict types

Usage

import {
  Tmdb
} from 'tmdb';
 
/**
 * @see https://developers.themoviedb.org/3/getting-started/authentication
 */
const apiKey: string = '';
 
const tmdb = new Tmdb(apiKey);
 

API

Refer to the source code and the type definitions.

Note: Only a subset of the API is implemented. I will be adding new methods as needed. If you need a method added, raise a PR. Alternatively, you can use the low-level get method to construct any API calls.

Handling errors

Methods that are expected to return a specific resource will throw NotFoundError if the resource is not found.

import {
  Tmdb,
  NotFoundError
} from 'tmdb';
 
const tmdb = new Tmdb([..]);
 
try {
  await tmdb.getMovie(1);
} catch (error) {
  if (error instanceof NotFoundError) {
    console.error('Movie TMDb ID #1 not found.');
  } else {
    throw error;
  }
}