Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A simple client that exposes Gowalla's API
branch: master

This branch is 1 commit behind drewyeaton:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
simplejson
README.md
gowalla.py
gowallatest.py

README.md

Gowalla Python Client

This python-gowalla library is a thin layer that exposes Gowalla's API. Although the data structure is likely to be a moving target, it hasn't changed in the past couple weeks. For now, this client only supports Gowalla's read-only methods. As some available calls are undocumented, I've only tested the ones that have been explicitly mentioned in the documentation and API explorer.

Usage

See gowallatest.py for example usage.

Documentation

View Gowalla API documentation and API Explorer for details on connection and various calls. The Gowalla Developers Group also has information (some heretofore undocumented) on other calls and details about the API.

Requirements

  • Python (2.5 or greater, but not 3.x)

Tested Methods

Get User

Returns information on a Gowalla user. Excepts username or user id.

/users/USERNAME
/users/USER_ID

List User's Friends

Returns a list of the user's friends. Excepts username or user id. This currently returns an empty list.

/users/USER_ID/friends
/users/USERNAME/friends

List User's Vaulted Items

Returns a list of the user's vaulted items. Excepts username or user id.

/users/USER_ID/vault
/users/USERNAME/vault

Get Spot

Returns information on a Gowalla spot.

/spots/SPOT_ID

List Spots Near Longitude/Latitude

Returns information on a Gowalla spot.

/spots/SPOT_ID?lat=LATITUDE&lng=LONGITUDE&radius=RADIUS

List Spot's Items

Returns a list of the items at a Gowalla spot.

/spots/SPOT_ID/items

List Trips

Returns a list of "official" Gowalla trips. This is likely to change as user contributed trips becomes live.

/trips 

Get Trip

Returns information on a Gowalla trip.

/trips/TRIP_ID

Get Item

Returns information on a Gowalla item.

/items/ITEM_ID

List Items

Returns a list of all Gowalla items.

/items

List Item's Events

Returns a list of things that have "happened" to the item.

/items/ITEM_ID/events
Something went wrong with that request. Please try again.