node-vine

Vine API for node.js

About

The Vine API is undocumented and not publicly available. However, it has a lot of great content. I noticed that there are a few python wrappers, so I wanted to create a node.js one. I also plan to do a few mobile web experiments with the Vine API, so this will come in handy for my next project. Have fun!

Install

npm install node-vine

API

All of Vine's API calls are authenticated, so you'll need to login first. You can add VINE_USERNAME and VINE_PASSWORD to your environment variables to hide them from being passed in the clear.

.login(username, password[, callback(err, response)])

Only supports e-mail address authentication. Twitter OAuth authentication to come later.

vine.login("[email protected]", "p@ssw0rd", function(err, response) {
  // Logged in!  Now you can use any other authenticated API... Like fetching your timeline or the most popular videos.
});

.timeline([ callback(err, response)])

Returns a user's timeline

vine.timeline(function(err, response) {
  // response contains a list of Vines in your timeline
});

.popular([ callback(err, response)])

Returns a list of the most popular Vines

vine.popular(function(err, response) {
  // response contains a list the most popular Vines
});

.promoted([ callback(err, response)])

Returns a list of promoted Vines

vine.promoted(function(err, response) {
  // response contains a list of promoted Vines
});

.tags(query[, callback(err, response)])

Performs a search for Vines with an associated tag

vine.tags("lolcats", function(err, response) {
  // response contains a list of lolcats Vines
});

.search(query[, callback(err, response)])

Performs a search for Vine users

vine.search("dave", function(err, response) {
  // response contains a list of Vine users matching "dave"
});

.settings([ callback(err, response)])

Returns a user's settings

vine.settings(function(err, response) {
  // response contains a user's Vine account settings
});

Notes

Inspired by vino, a python app that displays a wall of popular Vines.

License

MIT