Skip to content

nawa/node-kinopoisk-ru

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status

Node.js module for getting film info from kinopoisk.ru, searhing films by query. Operations support login to avoid a ban when you do many requests

##Usage

var kinopoisk = require('kinopoisk-ru');

kinopoisk.search('The Shawshank Redemption', null, function(err, films){
	if(err){
		console.error(err.message);
	}else{
		console.dir(films);
	}
});


kinopoisk.getById('326', null, function(err, film){
	if(err){
		console.error(err.message);
	}else{
		console.dir(film);
	}
});

##Methods That is simple, available only three functions ###getById(id, options, callback)

  • id - kinopoisk film id
  • options - if null the default options will be passed. Options contains next values
{ loginData: [], //login data from login(user, password, callback) function. Can be null or empty
  title: true, //include attribute to result or not
  rating: true, //...
  votes: true, //...
  alternativeTitle: true, //...
  type: true, //...
  description: true, //...
  actors: true, //...
  year: true, //...
  country: true, //...
  director: true, //...
  scenario: true, //...
  producer: true, //...
  operator: true, //...
  composer: true, //...
  cutting: true, //...
  genre: true, //...
  budget: true, //...
  boxoffice: true, //...
  time: true //...
}
  • callback(err, film) - film is requested film info with attributes passed into options. Attributes like actors, director, scenario are arrays. Type is 'series' or 'film'. Year, rating etc are numbers

###search(query, options, callback)

  • query - film name
  • options - if null the default options will be passed. Options contains next values
{ loginData: [], //login data from login(user, password, callback) function. Can be null or empty
  limit: 5, //result limit
  parse: true, 	//parse or not resulting films. If true then results will be parsed like in getById(). 
  		//If false then only films id and title will be returned
  parsingOptions: DEFAULT_GET_OPTIONS //Used only if parse is true. Similar to options in getById()
}
  • callback(err, films) - films is array of requested films, parsed or not dependent from option.parse

###login(user, password, callback) To avoid a ban when you do many requests use login with your kinopoisk credentials

  • user - kinopoisk user name
  • password - kinopoisk user password
  • callback(err, loginData) - loginData must be passed to getById() or search() options

Example

kinopoisk.login('username', 'userpassword', function(err, loginData){
	var options = {
		loginData: loginData,
		title: true
	};
	kinopoisk.getById('326', options, function(err, film){
		if(err){
			console.error(err.message);
		}else{
			console.dir(film);
		}
	});
})

About

Node.js module for getting film info from kinopoisk.ru

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published