Admin

Personal API of Stefan Grund

Welcome. This API collects social media and quantified self data by Stefan Grund. Right now there are 3 endpoints available to interact with data from Fitbit, Foursquare and Twitter. Here is a short documentation of the public API calls. (If you're logged in, you can view the full documentation here.)

Authentication

While the API supports all CRUD operations, only reading data is allowed for the public. You'll need to add the public access token 127542604153346df5d16cb to your request in order to perform it, like this:

http://api.stefangrund.de/v1/places?token=127542604153346df5d16cb

Resources and Parameters

You can call the following resources. Use the parameter date=YYYY-MM-DD to limit the timespan of your request. Use format to determine the format of the response (you can choose between the default json or xml) and count to determine the number of items in the response (default is 25, maximum is 200).

/v1/places – My check-ins and locations (with geographic coordinates).

[
    {
        "id": 6,
        "date": "2014-01-26 17:52:54",
        "place": "Cinenova",
        "comment": "12 Years a Slave.",
        "lat": "50.95134309",
        "lng": "6.91153123",
        "org_service": "Foursquare",
        "org_id": "52e53d6611d28d5cd6501967"
    }
    ...
]

/v1/statuses – My status updates.

[
    {
        "id": 546,
        "date": "2014-02-17 17:44:26",
        "status": "Working on my Personal API... #bachelorthesis",
        "org_service": "Twitter",
        "org_id": "435469804527682000"
    }
    ...
]

/v1/steps – My daily number of steps.

[
    {
        "id": 35,
        "date": "2014-02-04 00:00:00",
        "steps": 12040,
        "org_service": "Fitbit"
    }
    ...
]

Example API Calls

A complete GET request for /v1/statuses with all parameters will look like this:

http://api.stefangrund.de/v1/statuses?date=2016-12-10&count=10&format=xml&token=127542604153346df5d16cb

You can also request single items from a resource. Just add /id to a call:

http://api.stefangrund.de/v1/steps/35?token=127542604153346df5d16cb