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:
Just execute the command at the terminal:
$ python setup.py 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 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) #Access all its attributes print result.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. """
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 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: