Unofficial Fitocracy Runs API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Unofficial Fitocracy Runs API

A RESTful Way To Get Data About Not Resting

There is currently no official Fitocracy API and I wanted a way to get at my running information (plus I wanted an excuse to learn how to use Ruby and Heroku), so I wrote this. It could certainly be expanded to become a more complete unofficial API if someone were motivated enough to work through the rest of the parsing.

I'm sure that Fitocracy will come out with its own official API soon, but for now I hope this some useful, basic read-only access to some data.

API Usage

This unofficial RESTful API returns a json result from Fitocracy about a user's running history. The main usage URL is:

To limit the number of runs retured add another LIMIT parameter:

This will provide a responce in the following format:

  "username": "dorkrawk",
  "userid": "138850",
  "userpic": "",
  "runs": [
      "datetime": "2012-08-13T20:50:36-05:00",
      "activity": "Running",
      "time": "0:27:28",
      "distance_i": "4",
      "units_i": "mi",
      "distance_m": "6.4",
      "units_m": "km",
      "points": "708",
      "note": "Felt like doing a faster run today... 6:52 miles, not bad."
      "datetime": "2012-08-12T13:50:47-05:00",
      "activity": "Running",
      "time": "1:07:20",
      "distance_i": "6.9",
      "units_i": "mi",
      "distance_m": "11.2",
      "units_m": "km",
      "points": "876",
      "note": "Ran w/ Eileen to Caesar Chavez Park, ran around the park a bit then came home.  A really nice little run. "