ky-tmdb

Easy to use and straightforward module to interact with the TheMovieDatabase API. Aimed at simplicity, lightweight and low-dependency.

API Key

Generate an API key for your use case. Generating keys can be done here: https://www.themoviedb.org/settings/api

Setup

To initialize the ky-TMDB package, construct a new instance

const KyTMDB = require('ky-tmdb');
const tmdb = new KyTMDB(options);

Options

apiKey

Set the API key to be used by the module, mandatory field

language

Set the language globally for the TMDB API, by default no language parameter will be sent. Can be overridden in the method's options

adultContent

Set the adult content filtering globally for the TMDB API. By default, false (no adult content).

Using this module

Almost all methods described on the API page are implemented (https://developers.themoviedb.org/3/). The TMDB instance contains the following objects:

• Discover
• Find
• Search
• Movies
• TV
• TVSeasons
• TVEpisodes
• Genres
• Companies
• Collections

Those objects will contain the methods as described by the API documentation. For example:

tmdb.TVEpisodes.getDetails('76479', 1, 1);

Changing Language

The language can be set using one of three methods, and must be supplied in either ISO-639-1 or ISO-3166-1 format.

• As option in the KyTMDB constructor, key name is language
• Using the tmdb.setLanguage method
• As option in the specific API method, key name is language

Changing Adult Content Mode

For ease of implementation, a toggle has been added to include/exclude adult content

• As option in the KyTMDB constructor, key name is adultContent
• Using the tmdb.setAdultContentMode method

Changing API Key

The API Key can be set using one of two methods and is required to use this module

• As option in the KyTMDB constructor, key name is apiKey
• Using the tmdb.setAPIKey method