Python Wrapper for Foursquare ( API

foursquare, library, api
pip install pyfoursquare==0.0.14



PyFoursquare is a Python interface for the Foursquare API.

If you are looking for a complete foursquare-APIv2 reference, go to


How to Install it

After download the source code by:

easy_install pyfoursquare


Just execute the command at the terminal:

$ python install

How to Use it

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
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
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.


Now you can go on by the line 33.


How to Use it with Django simple example

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 syncdb

This command above will sync and create the tables using sqlite3.

Now edit the file and place your Developer's App Credentials:


Save it. Now run the command at the terminal:

$ python 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!