imvdb
v1.0.0
Published
A NodeJS Package to interact with IMVDb's API
Downloads
5
Maintainers
Readme
IMVDb
What is this?
An NPM package to interact with the IMBDb.com API
Quick Start
Install in your app directory
npm install imvdb
then
const IMVDb = require('imvdb')('API_KEY_HERE');
You can get your own API Key from IMVDb.com. You will need an account.
API calls are limited to 1,000 calls per minute. Keep that in mind.
Search Videos
Basic search. Returns IMBDb information. Use videoData to get youtube links.
IMVDb.searchVideos('Eye of the tiger').then(function( response){
console.log( response.results );
}, console.error);
Search Entities
An entity is anything with a name in the IMVDb Database (artists, companies, people, etc). You can retreive basic information on an entity as well as information like credits and associated videos.
IMVDb.searchEntities('Michel Gondry').then(function( response){
console.log( response.results );
}, console.error);
Video Information
For things like youtube links
imvdb.videoData(199998171889).then(function( response ){
console.log(`Title: ${response.song_title}`)
// Filter youtube sources
let target = response['sources'].filter(function( item ){
return item.source === 'youtube';
}).shift(); // Get first youtube link
console.log(`YouTube: https://www.youtube.com/watch?v=${target['source_data']}`)
})
Entity Information
Additional information about an entity.
imvdb.entityData(634).then(function( response ){
console.log( response )
})