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!

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("[e-mail]", "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