Marathon Data Access API

Using the API

Using the API is very simple, all you have to do is include the "API-Key" header in a HTTP GET request to any of the methods below. This is your personal API key, it'll be valid untill the next time you change your password:
You have to log in to view your API-Key.
With this key you'll be granted 100 API call tokens. You currently have n/a tokens and every API call will consume one. You will be granted a new token one hour after consuming one.
You can also specify whether you want the response in JSON or XML, simply set the Accept HTTP header to "application/xml" or "application/json":
Accept: application/xml

Sample

Request

GET /API/v1/Status
Accept: application/json
API-Key:
Host: www.marathon-mobile.net

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 33

{"Tokens":96,"Username":"Sample"}

Methods

GET /API/v1/Status

A test method for debugging purposes, returns the number of API tokens you have left as well as your username.

GET /API/v1/Results

Returns a list of all your results.

GET /API/v1/Kml/*id*?unit=*unit*

id: The ID of the result.
unit: Metric or Imperial.
Returns a result as a Keyhole Markup Language (KML) file.

GET /API/v1/Gpx/*id*?unit=*unit*

id: The ID of the result.
unit: Metric or Imperial.
Returns a result as a GPS Exchange Format (GPX) file.

GET /API/v1/Csv/*id*?unit=*unit*

id: The ID of the result.
unit: Metric or Imperial.
Returns a result as a Comma Separated Values (CSV) file.
 
Blog | Mobile view