Skip to content


Subversion checkout URL

You can clone with
Download ZIP
node.js library for foursqaure api
branch: master
Failed to load latest commit information.
lib photo api v1
.gitignore Initial commit
index.js photo api v1


node.js library for foursqaure api

It's under development, DO NOT USE IN PRODUCTION.

There are couple of foursquare api libs out there (I know), but none of them can make interactions (like checkin etc), (node-4sq)[] almost can.


API isn't final!.

But here are some working examples.

var foursquare = require( "foursquare" )(
        client_id: "yyyyyy",
        client_secret: "xxxxxx"
    Venue = foursquare.Venue,
    Notification = foursquare.Notification,
    Checkin = foursquare.Checkin;

Venue.findById( "4e311a73628430b0810a6194", function( err, result ){
    // scumbag foursquare returns a lot of things in response, so result contains everything
    result.venue instanceof Venue; //true
    result.notification instanceof Notification; // true. Warning: result.notification will be null if you aren't logged in or foursquare hasn't sent it.

    // Here's come the good part:
        .accessToken( "user-access-token" ) // in express it could be: req.user.foursquare.accessToken or sg like that
            shout: "SHOUT SOMETHING"
        }, function( err, result ){
            result.checkin instanceof Checkin; // true

Do you want raw JSON objects? That's okay:

Venue.findById( "4e311a73628430b0810a6194" )
    .then(function( body ){
        // body contains the stuff
        body._response; // body._response is the ClientResponse object from the http request
    .fail(function( err ){


Hey is that response only available if i'm using promises? No:

Venue.findById( "4e311a73628430b0810a6194", function( err, result ){
    if( err ){
        return console.log( "are you down foursquare?", err._response.statusCode );
    var headers = result._response.headers;
    console.log( "i can call the api in the 1 hour ", headers[ "x-ratelimit-limit" ] - headers[ "x-ratelimit-remaining" ], "x times!" );
Something went wrong with that request. Please try again.