API - World Records

Retrieve the current world records.

URL

Type	URL
XML	https://speedskatingresults.com/api/xml/world_records.php
JSON	https://speedskatingresults.com/api/json/world_records.php

Parameters

Name	Description
gender	Gender (optional) - f (female) or m (male) If specified, limits the returned records to those for women or men.
age	Age category (optional) - jr (junior) or sr (senior) If specified, limits the returned records to those for juniors or seniors.
distance	Distance (optional) When the distance parameter is omitted, the world records for all distances are returned. Specify a value (500, 1000, 1500, 3000, 5000 or 10000) for the distance parameter to retrieve the world record for that distance only.

Name

Description

gender

Gender (optional) - f (female) or m (male)

If specified, limits the returned records to those for women or men.

age

Age category (optional) - jr (junior) or sr (senior)

If specified, limits the returned records to those for juniors or seniors.

distance

Distance (optional)

When the distance parameter is omitted, the world records for all distances are returned. Specify a value (500, 1000, 1500, 3000, 5000 or 10000) for the distance parameter to retrieve the world record for that distance only.

XML

Element	Description
wrs	The list of world records
record	A world record Attributes gender - f (women's record) or m (men's record) age - sr (senior) or jr (junior) record
distance	Race distance
time	Finishing time
date	Race date (YYYY-MM-DD)
location	Race location
skater	The record holder
id	The skater's ID
familyname	The skater's family name
givenname	The skater's given name
familynative	The skater's family name in native language (if available)
givennative	The skater's given name in native language (if available)
country	The skater's IOC country code

Example

API Query: https://speedskatingresults.com/api/xml/world_records?gender=m&age=sr

<?xml version="1.0" encoding="utf-8" ?>
<wrs>
<record gender="m" age="sr">
  <distance>500</distance>
  <time>34,03</time>
  <date>2007-11-09</date>
  <location>Salt Lake City (USA)</location>
  <skater>
    <id>130</id>
    <familyname>Wotherspoon</familyname>
    <givenname>Jeremy</givenname>
    <country>CAN</country>
  </skater>
</record>
<record gender="m" age="sr">
  <distance>1000</distance>
  <time>1.06,42</time>
  <date>2009-03-07</date>
  <location>Salt Lake City (USA)</location>
  <skater>
    <id>265</id>
    <familyname>Davis</familyname>
    <givenname>Shani</givenname>
    <country>USA</country>
  </skater>
</record>
<record gender="m" age="sr">
  <distance>1500</distance>
  <time>1.41,04</time>
  <date>2009-12-11</date>
  <location>Salt Lake City (USA)</location>
  <skater>
    <id>265</id>
    <familyname>Davis</familyname>
    <givenname>Shani</givenname>
    <country>USA</country>
  </skater>
</record>
<record gender="m" age="sr">
  <distance>3000</distance>
  <time>3.37,28</time>
  <date>2005-11-05</date>
  <location>Calgary (CAN)</location>
  <skater>
    <id>317</id>
    <familyname>Ervik</familyname>
    <givenname>Eskil</givenname>
    <country>NOR</country>
  </skater>
</record>
<record gender="m" age="sr">
  <distance>5000</distance>
  <time>6.03,32</time>
  <date>2007-11-17</date>
  <location>Calgary (CAN)</location>
  <skater>
    <id>831</id>
    <familyname>Kramer</familyname>
    <givenname>Sven</givenname>
    <country>NED</country>
  </skater>
</record>
<record gender="m" age="sr">
  <distance>10000</distance>
  <time>12.41,69</time>
  <date>2007-03-10</date>
  <location>Salt Lake City (USA)</location>
  <skater>
    <id>831</id>
    <familyname>Kramer</familyname>
    <givenname>Sven</givenname>
    <country>NED</country>
  </skater>
</record>
</wrs>

JSON

Key	Description
records	The collection of world records
gender	f (women's record) or m (men's record)
age	sr (senior) or jr (junior) record
distance	Race distance
time	Finishing time
date	Race date (YYYY-MM-DD)
location	Race location
skater	The record holder
id	The skater's ID
familyname	The skater's family name
givenname	The skater's given name
familynative	The skater's family name in native language (if available)
givennative	The skater's given name in native language (if available)
country	The skater's IOC country code

Example

API Query: https://speedskatingresults.com/api/json/world_records?age=sr

{
  "records":[
    {"gender":"f", "age":"sr", "distance":500, "time":"36,36", "date":"2013-11-16", "location":"Salt Lake City (USA)",
      "skater":{"id":1195, "familyname":"Lee", "givenname":"Sang-Hwa", "familynative":"이", "givennative":"상화", "country":"KOR"}},
    {"gender":"f", "age":"sr", "distance":1000, "time":"1.11,61", "date":"2019-03-09", "location":"Salt Lake City (USA)",
      "skater":{"id":29245, "familyname":"Bowe", "givenname":"Brittany", "country":"USA"}},
    {"gender":"f", "age":"sr", "distance":1500, "time":"1.49,83", "date":"2019-03-10", "location":"Salt Lake City (USA)",
      "skater":{"id":12830, "familyname":"Takagi", "givenname":"Miho", "familynative":"髙木", "givennative":"美帆", "country":"JPN"}},
    {"gender":"f", "age":"sr", "distance":3000, "time":"3.52,02", "date":"2019-03-09", "location":"Salt Lake City (USA)",
      "skater":{"id":22, "familyname":"Sáblíková", "givenname":"Martina", "country":"CZE"}},
    {"gender":"f", "age":"sr", "distance":5000, "time":"6.39,02", "date":"2020-02-15", "location":"Salt Lake City (USA)",
      "skater":{"id":17787, "familyname":"Voronina", "givenname":"Natalia", "familynative":"Воронина", "givennative":"Наталья", "country":"RUS"}},
    {"gender":"f", "age":"sr", "distance":10000, "time":"13.48,33", "date":"2007-03-15", "location":"Calgary (CAN)",
      "skater":{"id":22, "familyname":"Sáblíková", "givenname":"Martina", "country":"CZE"}},
    {"gender":"m", "age":"sr", "distance":500, "time":"33,61", "date":"2019-03-09", "location":"Salt Lake City (USA)",
      "skater":{"id":17178, "familyname":"Kulizhnikov", "givenname":"Pavel", "familynative":"Кулижников", "givennative":"Павел", "country":"RUS"}},
    {"gender":"m", "age":"sr", "distance":1000, "time":"1.05,69", "date":"2020-02-15", "location":"Salt Lake City (USA)",
      "skater":{"id":17178, "familyname":"Kulizhnikov", "givenname":"Pavel", "familynative":"Кулижников", "givennative":"Павел", "country":"RUS"}},
    {"gender":"m", "age":"sr", "distance":1500, "time":"1.40,17", "date":"2019-03-10", "location":"Salt Lake City (USA)",
      "skater":{"id":5487, "familyname":"Nuis", "givenname":"Kjeld", "country":"NED"}},
    {"gender":"m", "age":"sr", "distance":3000, "time":"3.37,28", "date":"2005-11-05", "location":"Calgary (CAN)",
      "skater":{"id":317, "familyname":"Ervik", "givenname":"Eskil", "country":"NOR"}},
    {"gender":"m", "age":"sr", "distance":5000, "time":"6.01,86", "date":"2017-12-10", "location":"Salt Lake City (USA)",
      "skater":{"id":1798, "familyname":"Bloemen", "givenname":"Ted-Jan", "country":"CAN"}},
    {"gender":"m", "age":"sr", "distance":10000, "time":"12.32,95", "date":"2021-02-14", "location":"Heerenveen (NED)",
      "skater":{"id":14119, "familyname":"van der Poel", "givenname":"Nils", "country":"SWE"}}
  ]
}

Example Web Page

The sample web page provides a very basic example of how XML data may be retrieved from SpeedskatingResults.com. It makes use of the jQuery library to handle the the interaction with the API.

World Records Example Page (XML)

World Records Example Page (JSON)

HTML Code (XML)

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  <style type="text/css" media="screen">
    body {font-family: 'Lucida Grande', Verdana, Arial, sans-serif; padding: 5px;
      font-size: 10pt;}
    table.records {margin: 1em; border-collapse: collapse; }
    table.records td {padding: .2em .5em; }
    table.records td.distance {width: 8em; font-weight: bold;}
    table.records td.time {width: 5em; text-align: right;}
    table.records td.date {}
    table.records td.location {width: 10em;}
    table.records td.skater {width: 15em;}
    a {color: navy; text-decoration: none; font-weight: bold;}
    a:visited {font-weight: normal;}
    a:hover {color: crimson;}
  </style>
  <title>API Example - World Records</title>
  <script type="text/javascript" src="jquery-1.7.2.min.js"></script>
  <script type="text/javascript">
  $(document).ready(function(){
    $.ajax({
      type: "GET",
      url: "https://speedskatingresults.com/api/xml/world_records.php",
      data: "age=sr",
      dataType: "xml",
      success: function(xml) {
        $(xml).find('record').each(function() {
          var recordClass = ($(this).attr('gender') == "m") ? "Men" : "Women";
          var distance = $(this).find('distance').text()+"m";
          var time = $(this).find('time').text();
          var date = $(this).find('date').text();
          var location = $(this).find('location').text();
          var skater = $(this).find('givenname').text() + " " +
            $(this).find('familyname').text() +
            " (" + $(this).find('country').text() + ")";
          $('<tr></tr>').html('<td class="distance">'+recordClass+' '+distance+
            '</td><td class="time">'+time+'</td><td class="date">'+date+
            '</td><td class="location">'+location+
            '</td><td class="skater">'+skater+'</td>').appendTo('#wrs');
        });
      }
    });
  });
  </script>
</head>
<body>
  <h1>World Records</h1>
  <table id="wrs" class="records">
  </table>
  <p><a href="https://speedskatingresults.com/index.php?p=9">Records</a> from
    <a href="https://speedskatingresults.com">SpeedskatingResults.com</a></p>
</body>
</html>

HTML Code (JSON)

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  <style type="text/css" media="screen">
    body {font-family: 'Lucida Grande', Verdana, Arial, sans-serif; padding: 5px;
      font-size: 10pt;}
    table.records {margin: 1em; border-collapse: collapse; }
    table.records td {padding: .2em .5em; }
    table.records td.distance {width: 8em; font-weight: bold;}
    table.records td.time {width: 5em; text-align: right;}
    table.records td.date {}
    table.records td.location {width: 10em;}
    table.records td.skater {width: 15em;}
    a {color: navy; text-decoration: none; font-weight: bold;}
    a:visited {font-weight: normal;}
    a:hover {color: crimson;}
  </style>
  <title>API Example - World Records</title>
  <script type="text/javascript" src="jquery-1.7.2.min.js"></script>
  <script type="text/javascript">
  $(document).ready(function(){
    $.ajax({
      type: "GET",
      url: "https://speedskatingresults.com/api/json/world_records.php",
      data: "age=sr",
      dataType: "json",
      success: function(data) {
        data.records.forEach(function(r) {
          var recordClass = (r.gender == "m") ? "Men" : "Women";
          var distance = r.distance + "m";
          var skater = r.skater.givenname + " " + r.skater.familyname;

          $('<tr></tr>').html('<td class="distance">'+recordClass+' '+distance+
            '</td><td class="time">'+r.time+
            '</td><td class="date">'+r.date+
            '</td><td class="location">'+r.location+
            '</td><td class="skater">'+skater+'</td>').appendTo('#wrs');
        });
      }
    });
  });
  </script>
</head>
<body>
  <h1>World Records</h1>
  <table id="wrs" class="records">
  </table>
  <p><a href="https://speedskatingresults.com/index.php?p=9">Records</a> from
    <a href="https://speedskatingresults.com">SpeedskatingResults.com</a></p>
</body>
</html>

Native Language Names