❤
npm
Sign UpSign In

node-hypem

0.0.6 • Public • Published

Hypem NodeJS Wrapper

This is an unofficial nodejs wrapper around the (undocumented? -- I couldn't find anything) Hype Machine (http://hypem.com) public API. It is a port of @JackCA's implementation of a Ruby gem of the API. Note that there are some differences.

Installation

npm install node-hypem

Usage

For general usage:

var Hypem = require("node-hypem");

The Hypem object has both a Playlist object, which can grab information about the various song lists on the hypem website, and a User object which returns playlists specific to the provided user.

All callbacks are of the form function(err, response).

Playlist

Playlist functions return JSON playlist data. All parameters except for filter are required (which defaults to all). As the API does not provide cursors, paging may have concurrency issues if you don't monitor changes.

// Filter options: "all", "lastweek", "remix", "noremix", "artists", "twitter"
Hypem.playlist.popular(filter, page_number, callback)
 
// Filter options: "all", "remix", "noremix", "fresh", or country code 
// ("ca", "us", "fr", etc) 
Hypem.playlist.latest(filter, page_number, callback)
 
Hypem.playlist.artist(artist_name, page_number, callback)
 
// "blog_id" is the siteid (number), not it's name
Hypem.playlist.blog(blog_id, page_number, callback) 
 
Hypem.playlist.search(search_query, page_number, callback)
 
// API warns against using too many tags
Hypem.playlist.tags([tag_array], page_number, callback)

User

Hypem.user(user_name) creates a new user object. If the username is invalid, null is returned.

The following requests return playlists of tracks specific to the user.

Hypem.user(user_name).loved(page_number, callback)
Hypem.user(user_name).feed(page_number, callback)
Hypem.user(user_name).obsessed(page_number, callback)
Hypem.user(user_name).people(page_number, callback)
Hypem.user(user_name).people_history(page_number, callback)
Hypem.user(user_name).people_obsessed(page_number, callback)

Additionally, the following user specific requests are also available:

// Returns null on invalid username
Hypem.user(user_name).get_profile(callback)
 
// Returns [ ] on invalid username/no friends
Hypem.user(user_name).get_friends(callback)
 
// Returns null on invalid username/no favorite blogs
Hypem.user(user_name).get_favorite_blogs(callback)

Readme

Keywords

Package Sidebar

Install

npm i node-hypem

Repository

github.com/samshelley/node-hypem

Homepage

github.com/samshelley/node-hypem

Weekly Downloads

1

Version

0.0.6

License

MIT

Last publish

Collaborators

  • samshelley
Try on RunKit
Report malware