ez-movie-node

1.0.6 • Public • Published

ez-movie-node - A TMDb API wrapper

ez-movie-node is a TMDb API wrapper. I designed this because other Javascript or Node packages are quite outdated (the most recent is from August 2017) so I thought I make one on my own to accomodate recent updates.

The package is still Work in Progress, so don't expect everything to work correctly (see notes below).

Installation

npm i ez-movie-node

importing the package

const EZMovie = require("ez-movie-node")
const ezmovie = new EZMovie(YOUR_API_KEY)

Making a fetch call

const main = async () => {
  const response = await ezmovie.certification.movie({})
  const body = await response.json()

  // OR

  ezmovie.ceritifcaiton.movie({})
  .then(res => res.json())
  .then(body => // do stuff)
}

As you can see the methods are promises so either doing .then() or await works. Don't forget to catch errors.

NOTE: Right now there is a problem within the system which prevents running methods which have optional query parameters. If you pass nothing into the method it will error. To prevent erroring always pass an empty object (you can leave methods which don't have any parameters empty). This will be fixed and you won't see this message in the future.

For instance ezmovie.certification.movie has no optional parameters so doing ezmovie.certification.movie() is valid.

Fetch call on a method with required parameters

// ezmovie.company.details has 1 required parameter (just like in the API documentation)
// company_id: integer

// This is how you make a call like this
const main = async () => {
  const response = await ezmovie.company.details({ company_id: 5})
  const body = await response.json()
}

Documentation

The methods are inline with the way the API documentation from TMDb is structured. Please see there for information on what parameters you need to pass in.

Available methods

endpoint methods
certification movie
tv
changes movie
tv
person
collection details
images
translations
company details
alternativeNames
images
configuration APIConfiguration
countries
jobs
languages
primaryTranslations
timezones
credits details
discover movie
tv
find findByID
genre movies
tv
keyword details
movies

Half of the endpoints are missing (WIP). Also only get requests are allowed.

Example

endpoint = keyword method = movies

ezmovie.keyword.movies()

Roadmap

  • Implementing the missing endpoints
  • Better error handling
  • Fixing the weird empty object bug

Package Sidebar

Install

npm i ez-movie-node

Weekly Downloads

1

Version

1.0.6

License

MIT

Unpacked Size

33.2 kB

Total Files

10

Last publish

Collaborators

  • stuhl