[!IMPORTANT]
This library is considered feature-complete and will only receive updates for bug fixes. You may still create an issue if you have a feature request.
movie-info 
Fetch information, images, rating, description, etc. about a movie.
Try it on RunKit (Output)
Features
- Use anywhere, browser or Node - UMD (Browser Support)
- Works in React + NextJS client/server (uses isomorphic-fetch)
- Promise and Callback API
- Includes:
- Title
- Release Date
- Plot summary overview
- Poster and backdrop images
- IMDB rating + vote count
- Recent popularity rating
- Adult film (boolean)
Install
Using NPM:
$ npm install movie-infoIn the browser:
<!-- movieInfo window global -->
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/movie-info/index.min.js"></script>Usage
const movieInfo = require('movie-info')
movieInfo('Avatar').then(console.log)Callbacks
movieInfo('Avatar', function (error, response){
console.log(response)
})Search year + Error handling
movieInfo('Oceans Eleven', '1960').then(
function (response) {
// success
console.log(response)
//=> { ... }
},
function (error) {
// failed
}
})From the command line
$ npm install -g movie-info
$ movie-info --help
Usage
$ movie-info movie [year]
Example
$ movie-info 'Oceans Eleven' '1960'
//=> { ... }Response
Example output:
{
adult: false,
backdrop_path: '/lhkU86q5cszZkca9MVQLMvUAE6m.jpg',
id: 1640,
original_title: 'Crash',
release_date: '2004-09-10',
poster_path: '/pG8LL4LYMCr5uikhx9rewrW8352.jpg',
popularity: 3.30511799781063,
title: 'Crash',
vote_average: 6.9,
vote_count: 271,
imageBase: 'http://image.tmdb.org/t/p/original'
}Images
Combine the image_base with the desired path to create a complete image URL.
const imageUrl = movieInfo('Avatar')
.then(response => console.log(response.imageBase + response.poster_path))
/* OR */
var imageUrl = response.image_base + response.poster_path
//=> http://image.tmdb.org/t/p/original/pG8LL4LYMCr5uikhx9rewrW8352.jpgAPI
movieInfo(movie [, year ] [, callback])
Returns a Promise which resolves to a movie object.
movie
Required
Type: string
Movie title to search for.
year
Type: string
Movie release year to search for. (optional)
callback(error, result)
Type: function
Callback function. (optional)
Related
License
This package uses data from TMDB. You may consult TMDB terms of service for usage rights.