No commit activity in last 3 years
No release in over 3 years
foursquare-api is a Ruby wrapper for the new Foursqauare V2 API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.0.0
~> 1.5.2
>= 0
 Project Readme

foursquare-api¶ ↑

foursquare-api is a Ruby wrapper for the new Foursqauare V2 API

installation¶ ↑

$ gem install foursquare-api

usage¶ ↑

venue = Foursquare::Venue.new(access_token)

venue.search({:ll => “37.792694,-122.409325”})

{“meta”=>{“code”=>200},

"response"=>{"groups" =>  [{   "type"=>"trending",
                               "name"=>"Trending Now",
                               "items"=>[{ "id"=>"4330a280f964a520fa271fe3",
                                           "name"=>"Supperclub",
                                           "contact"=>{"phone"=>"4153480900"},
                                           "location"=>{"address"=>"657 Harrison St",
                                           "crossStreet"=>"btw 2nd & 3rd St",
                                           "city"=>"San Francisco",
                                           "state"=>"CA",
                                           "postalCode"=>"94107",
                                           "country"=>"USA",
                                           "lat"=>37.783223,
                                           "lng"=>-122.396472,
                                           "distance"=>1545},
                                           "categories"=>[{"id"=>"4bf58dd8d48988d121941735",
                                                           "name"=>"Lounge",
                                                           "icon"=>"http://foursquare.com/img/categories/nightlife/lounge.png",
                                                           "parents"=>["Nightlife"],
                                                           "primary"=>true}],
                                           "verified"=>false,
                                           "stats"=>{"checkinsCount"=>1306, "usersCount"=>950},
                                           "todos"=>{"count"=>0},
                                           "specials"=>[],
                                           "hereNow"=>{"count"=>5}}]}}

supported endpoints¶ ↑

Checkins¶ ↑

  • add

  • recent

  • addcomment

  • deletecomment

Photo (Beta)¶ ↑

  • add

Setting¶ ↑

  • all

  • set

Tips¶ ↑

  • add

  • search

  • marktodo

  • markdone

  • unmark

User¶ ↑

  • search

  • request

  • badges

  • checkins

  • friends

  • tips

  • todos

  • venuehistory

  • request

  • unfriend

  • approve

  • deny

  • setpings

Venue¶ ↑

  • add

  • categories

  • search

  • herenow

  • tips

  • marktodo

  • flag

  • proposeedit

Contributing to foursquare-api¶ ↑

  • If you have made any improvements to the foursquare-api gem and want to release it under this branch, feel free to contact me on github. I’ll add you as a contributor.

  • Otherwise, feel free to fork this branch. Just remember to include me in the README.

Copyright¶ ↑

Copyright © 2011 Ronald Wan. See LICENSE.txt for further details.