TMDB SDK

Deno-first TypeScript library for interacting with themoviedb.org’s (TMDB) API.

This library transforms fetched data to make it more idiomatic for JavaScript/TypeScript.

• Replaces snake_case properties with camelCase
• Renames properties where appropriate
• Properties which would sometimes have null or empty string values ("") now use optional values instead

Table of Contents

• Error Handling
• API v3
  • Countries
  • Genres
  • Languages
  • Movies
    • Search
• Roadmap

Error Handling

The API returns 200, 401, and 404 responses. The SDK throws an Error when a 401 or 404 response is received. The full Response will be assigned to Error.cause, and Error.message will be either a specific status message returned by the API if present, or the value of Response.statusText otherwise.

Additionally the standard fetch function used internally throws a TypeError when a network issue is encountered.

API v3

https://developers.themoviedb.org/3/getting-started/introduction

Countries

Source:

• https://developers.themoviedb.org/3/configuration/get-countries

import { COUNTRIES, getCountries } from "path/to/v3/countries/mod.ts";
import type {
  Country,
  CountryCode,
  CountryMap,
} from "path/to/v3/countries/mod.ts";

Genres

Source:

• https://developers.themoviedb.org/3/genres/get-movie-list

import { getMovieGenres, MOVIE_GENRES } from "path/to/v3/genres/mod.ts";
import type { GenreMap, MovieGenre } from "path/to/v3/genres/mod.ts";

Languages

Source:

• https://developers.themoviedb.org/3/getting-started/languages
• https://developers.themoviedb.org/3/configuration/get-languages

import { getLanguages, LANGUAGES } from "path/to/v3/languages/mod.ts";
import type {
  Language,
  LanguageCode,
  LanguageMap,
} from "path/to/v3/languages/mod.ts";

Movies

Search

Source:

• https://developers.themoviedb.org/3/search/search-movies

import { searchMovies } from "path/to/v3/movies/mod.ts";
import type {
  MovieSearchResult,
  SearchMoviesOptions,
  SearchResultsPage,
} from "path/to/v3/languages/mod.ts";

Roadmap

• Current Version: 0.1.0
• Completed: 4
• Slated: 145