PyFoursquare is a Python interface for the Foursquare API.
If you are looking for a complete foursquare-APIv2 reference, go to
<http://developer.foursquare.com/docs/>
After download the source code by:
easy_install pyfoursquare
or
https://github.com/marcelcaraciolo/foursquare/tarball/master
Just execute the command at the terminal:
$ python setup.py install
import pyfoursquare as foursquare
# == OAuth2 Authentication ==
#
# This mode of authentication is the required one for Foursquare
# The client id and client secret can be found on your application's Details
# page located at https://foursquare.com/oauth/
client_id = ""
client_secret = ""
callback = ''
auth = foursquare.OauthHandler(client_id, client_secret, callback)
#First Redirect the user who wish to authenticate to.
#It will be create the authorization url for your app
auth_url = auth.get_authorization_url()
print 'Please authorize: ' + auth_url
#If the user accepts, it will be redirected back
#to your registered REDIRECT_URI.
#It will give you a code as
#https://YOUR_REGISTERED_REDIRECT_URI/?code=CODE
code = raw_input('The code: ').strip()
#Now your server will make a request for
#the access token. You can save this
#for future access for your app for this user
access_token = auth.get_access_token(code)
print 'Your access token is ' + access_token
#Now let's create an API
api = foursquare.API(auth)
#Now you can access the Foursquare API!
result = api.venues_search(query='Burburinho', ll='-8.063542,-34.872891')
#You can acess as a Model
print dir(result[0])
#Access all its attributes
print result[0].name
"""
If you already have the access token for this user
you can go until lines 1- 13, and then get at
your database the access token for this user and
set the access token.
auth.set_access_token('ACCESS_TOKEN')
Now you can go on by the line 33.
"""Download the pyfoursquare/examples folder.
Go to the the django/example folder.
You must have django installed at your machine. Django is a popular and powerful web framework written in Python.
Now, just execute the command at the terminal:
$ python manage.py syncdb
This command above will sync and create the tables using sqlite3.
Now edit the settings.py file and place your Developer's App Credentials:
FOURSQUARE_CLIENT_ID = ''
FOURSQUARE_CLIENT_SECRET = ''
FOURSQUARE_CALLBACK = ''Save it. Now run the command at the terminal:
$ python manage.py runserver
It will run the web app. This demo will demonstrate the authentication procedure and show the user name and photo.
Just open the browser and go to the url:
Enjoy it!