Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

imvdb

DrKain4ISC1.0.0

A NodeJS Package to interact with IMVDb's API

npm, node, js, imvdb, internet, music, video, database

readme

IMVDb

NPM

What is this?

An NPM package to interact with the IMBDb.com API

Quick Start

Install in your app directory

`shell script npm install imvdb

then
```javascript
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 )
})