Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including dodge with all npm packages installed. Try it out:

var dodge = require("dodge")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

dodge v0.6.2

An API client for Foursquare's Venues Service

Dodge

An API client for Foursquare's Venues Service.

Installation

npm install dodge --save

Usage

Register your app with the Foursquare API to recieve a Client ID and Client Secret.

var Dodge, client, apiOptions;

Dodge = require('dodge');

client = new Dodge({
  clientId: 'four',
  clientSecret: 'square'
});

/* varies by endpoint; refer to Foursquare documentation */
apiOptions = {
  categoryId: '4bf58dd8d48988d122941735',
  intent: 'browse',
  near: 'Chicago, IL'
}

client.venues.search(apiOptions, function(err, venues){
  /* do something */
});

Endpoints

Dodge supports endpoints that are part of Foursquare's Venues Service and do not require user authentication.

General Endpoints

EndpointDescription (link to API documentation)Supported?
venues/categoriesVenue CategoriesYes :white_check_mark:
venues/exploreExplore Recommended and Popular VenuesNot Yet :x:
venues/searchSearch VenuesYes :white_check_mark:
venues/suggestcompletionSuggest Completion VenuesYes :white_check_mark:
venues/trendingTrending VenuesNot Yet :x:

Venue-specific Endpoints

EndpointDescription (link to API documentation)Supported?
venues/<venue>Venue DetailsYes :white_check_mark:
venues/<venue>/eventsVenue EventsYes :white_check_mark:
venues/<venue>/hoursVenue HoursYes :white_check_mark:
venues/<venue>/likesUsers who have liked a venueYes :white_check_mark:
venues/<venue>/linksLinks For a VenueYes :white_check_mark:
venues/<venue>/listedListsYes1 :white_check_mark:
venues/<venue>/menuVenue MenuYes :white_check_mark:
venues/<venue>/nextvenuesNext VenuesYes :white_check_mark:
venues/<venue>/photosPhotos from a VenueYes2 :white_check_mark:
venues/<venue>/tipsTips from a VenueYes :white_check_mark:

1: Does not accept a group parameter. Only others is supported without an acting user, so that parameter is passed by the library.

2: Supported group parameters: none or venue (checkin require an acting user, which is not supported.)

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free