Developer API

TweetARun believes your data is well, yours. So, we make all data available via a programming interface. We like to keep things simple so we use REST style programming with JSON and XML. Here's a list of the APIs you can use in your applications:

Basic API form: http://tweetarun.com/data.aspx?action=SOMETHING&username=SOMETHING& etc. etc.

Let the APIs begin....

"CHART"

http://tweetarun.com/data.aspx?action=chart&username=FrancisShanahan&from=6/1/2009

The "From" here is optional but if you add it you get back just data entered since that date. The JSON in this case is specially formatted to work with the Open Flash Chart component available from Google.

"RSS"

http://tweetarun.com/data.aspx?action=rss

Self explanatory. No JSON here, just RSS XML. You shouldn't use this one though, use our Feedburner feed which is http://feeds2.feedburner.com/tweetarun

"JSON"

http://tweetarun.com/data.aspx?action=json&username=FrancisShanahan

Gives you all the Runs for this user. Ever.

"STATS"

http://tweetarun.com/data.aspx?action=stats&username=FrancisShanahan

Gives you back the statistics for this user as well as a bunch of fun information. Try this one, it's fun.

"TOTALS"

http://tweetarun.com/data.aspx?action=totals

Just the total miles across all users.

"LIKE"

http://tweetarun.com/data.aspx?action=like&distance=123

Another fun one, pass in a distance (in miles only) and get back a comparison. "That's like running 97 miles MORE than a Marathon (26.22 miles)"

"RECENT"

http://tweetarun.com/data.aspx?action=recent

This last one gives you the folks who've run that week and how far.