Python wrapper for the foursquare v2 API. Originally developed to power Fondu.
Philosophy:
- Map foursquare's endpoints one-to-one
- Clean, simple, Pythonic calls
- Only handle raw data, you define your own models
Features:
- OAuth dance
- Automatic retries
- Full endpoint coverage (non-merchant)
- Full test coverage
- Useful exception classes
- Multi support (via beichhor)
Dependencies:
- requests
pip install foursquare
or
easy_install foursquare
Depending upon your system and virtualenv settings, these may require sudo permissions.
# Construct the client object
client = foursquare.Foursquare(client_id='YOUR_CLIENT_ID', client_secret='YOUR_CLIENT_SECRET', redirect_uri='http://fondu.com/oauth/authorize')
# Build the authorization url for your app
auth_uri = client.oauth.auth_url()
Redirect your user to the address auth_uri and let them authorize your app. They will then be redirected to your redirect_uri, with a query paramater of code=XX_CODE_RETURNED_IN_REDIRECT_XX. In your webserver, parse out the code value, and use it to call client.oauth.get_token()
# Interrogate foursquare's servers to get the user's access_token
access_token = client.oauth.get_token('XX_CODE_RETURNED_IN_REDIRECT_XX')
# Apply the returned access token to the client
client.set_access_token(access_token)
# Get the user's data
user = client.users()
client = foursquare.Foursquare(client_id='YOUR_CLIENT_ID', client_secret='YOUR_CLIENT_SECRET')
Authenticated User Access (when you already have a user's access_token)
client = foursquare.Foursquare(access_token='USER_ACCESS_TOKEN')
client = foursquare.Foursquare(client_id='YOUR_CLIENT_ID', client_secret='YOUR_CLIENT_SECRET', version='20111215')
or
client = foursquare.Foursquare(access_token='USER_ACCESS_TOKEN', version='20111215')
client.users()
client.users('1183247')
client.users.checkins()
client.users.checkins(params={'limit': 1})
client.users.all_checkins('1183247')
client.users.approve('1183247')
client.venues('40a55d80f964a52020f31ee3')
client.venues.search(params={'query': 'coffee'})
client.venues.edit('40a55d80f964a52020f31ee3', params={'description': 'Best restaurant on the city'})
client.checkins.recent()
client.checkins.recent('1183247')
client.tips('4b5e662a70c603bba7d790b4')
client.tips.search(params={'query': 'donuts'})
Note: endpoint methods map one-to-one with foursquare's endpoints
users()
users.leaderboard()
users.requests()
users.search()
users.badges()
users.checkins()
users.all_checkins() [*not a native endpoint*]
users.friends()
users.lists()
users.mayorships()
users.photos()
users.venuehistory()
users.approve()
users.deny()
users.request()
users.setpings()
users.unfriend()
users.update()
venues()
venues.add()
venues.categories()
venues.explore()
venues.search()
venues.trending()
venues.events()
venues.herenow()
venues.listed()
venues.menu()
venues.photos()
venues.similar()
venues.tips()
venues.edit()
venues.flag()
venues.edit()
venues.proposeedit()
checkins()
checkins.add()
checkins.recent()
checkins.addcomment()
checkins.addpost()
checkins.deletecomment()
checkins.reply()
tips()
tips.add()
tips.search()
tips.done()
tips.listed()
tips.markdone()
tips.marktodo()
tips.unmark()
lists()
lists.add()
lists.followers()
lists.suggestphoto()
lists.suggesttip()
lists.suggestvenues()
lists.additem()
lists.deleteitem()
lists.follow()
lists.moveitem()
lists.share()
lists.unfollow()
lists.update()
lists.updateitem()
photos()
photos.add()
settings()
settings.all()
settings.set()
specials()
specials.search()
specials.add()
specials.flag()
events()
events.categories()
events.search()
multi()
In order to run the tests:
- Copy foursquare/tests/_creds.example.py to foursquare/tests/_creds.py
- Fill in your personal credentials to run the tests (_creds.py is in .gitignore)
- Run
nosetests
What else would you like this library to do? Let me know. Feel free to send pull requests for any improvements you make.
- Bring in new endpoints as they emerge
- Test coverage for write methods
- Merchant-specific endpoints (someday)
MIT License. See LICENSE Copyright (c) 2013 Mike Lewis
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent