Skip to content

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

License

Notifications You must be signed in to change notification settings

23tux/foursquare-api

This branch is 2 commits ahead of ronaldwan/foursquare-api:master.

Folders and files

NameName
Last commit message
Last commit date
Mar 14, 2011
Jan 1, 2011
Jan 1, 2011
Mar 14, 2011
Jan 1, 2011
Jan 1, 2011
Jan 1, 2011
Mar 14, 2011
Jan 15, 2011
Mar 14, 2011
Mar 14, 2011

Repository files navigation

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

  • lookup(venue_id)

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.

Contributor

Hubert Hoelzl, fork on github

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%