> [!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:

``bash
$ npm install movie-info
`

In the browser:

`html


`
(via JSDelivr, or via Unpkg)




Usage

`js
const movieInfo = require('movie-info')

movieInfo('Avatar').then(console.log)
`

###### Callbacks
`js
movieInfo('Avatar', function (error, response){
console.log(response)
})
`

###### Search year + Error handling
`js
movieInfo('Oceans Eleven', '1960').then(
function (response) {
// success
console.log(response)
//=> { ... }
},
function (error) {
// failed
}
})
`

#### From the command line

`bash
$ npm install -g movie-info
$ movie-info --help

Usage
$ movie-info movie [year]

Example
$ movie-info 'Oceans Eleven' '1960'
//=> { ... }
`

##### Response

Example output:

`js
{
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.

`js
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.jpg
`




API

$3

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

* album-art
* movie-art
* movie-trailer

License

This package uses data from TMDB. You may consult TMDB terms of service for usage rights.

MIT © Lacy Morrow