API - Competition List (Track)

Get a list of competitions held at a track.

URL

Type URL
XML http://speedskatingresults.com/api/xml/track_competitions.php
JSON http://speedskatingresults.com/api/json/track_competitions.php

Parameters

Name Description
track

Track ID (required)

The track ID can be found in the table below.

season Season start year (optional). For example, to retrieve competitions for the 2011-2012 season, specify the value 2011.
  1. To always retrieve the competitions for the current season, omit the season parameter.
  2. The 2006-2007 season is the first for which results are available from SpeedskatingResults.com

Track IDs

TrackCountryId
Adavere EST 99
Akan JPN 125
Alkmaar NED 72
Alta NOR 247
Åmli-Dølemo NOR 195
Ammerstol NED 163
Amsterdam NED 118
Amsterdam-Olympic NED 244
Anchorage USA 183
Arendal NOR 94
Arkhangelsk-Trud RUS 160
Asahikawa JPN 153
Asama JPN 53
Asker NOR 68
Assen NED 88
Astana KAZ 203
Barnaul RUS 116
Basel SUI 119
Baselga di Pinè ITA 17
Båstad NOR 129
Bergen NOR 130
Berlin GER 22
Berlin-Wilmersdorf GER 214
Bjugn NOR 117
Borlänge SWE 245
Breda NED 64
Budapest HUN 16
Calgary CAN 5
Changchun CHN 102
Chelyabinsk RUS 57
Chelyabinsk-Inga RUS 219
Chemnitz GER 26
Cherepovecz RUS 149
Chino JPN 89
Chita RUS 206
Collalbo ITA 10
Crimmitschau GER 190
Daqing CHN 259
Davos SUI 20
Dawson Creek CAN 200
Den Haag NED 52
Deventer NED 80
Divnogorsk RUS 115
Drammen NOR 79
Dresden GER 63
Dronten NED 196
Ede NED 176
Edmonton CAN 261
Eidsvoll NOR 167
Eindhoven NED 12
Ekaterinburg RUS 74
El Calafate ARG 154
Elbląg POL 263
Ena JPN 126
Enschede NED 157
Erdenet MGL 155
Erfurt GER 14
Eskilstuna SWE 104
Falun SWE 228
Fort Saint John CAN 107
Fort St. James CAN 181
Frankfurt GER 87
Frösön SWE 166
Fujikyu JPN 121
Fukang CHN 224
Fushun CHN 267
Gangneung KOR 262
Geithus NOR 31
Geleen NED 132
Gjøvik NOR 204
Gol NOR 33
Göteborg SWE 29
Grefrath GER 27
Groningen NED 24
Grou NED 229
Haaksbergen NED 177
Haarlem NED 54
Hachinohe JPN 111
Hagaström SWE 134
Hailar CHN 215
Halifax CAN 198
Hamar NOR 8
Harbin CHN 47
Harstad NOR 67
Heerenveen NED 9
Helsinki FIN 60
Hengelo NED 222
Hol NOR 171
Holmestrand NOR 218
Hoorn NED 100
Hundorp NOR 141
Ikaho JPN 59
Innsbruck AUT 19
Inzell GER 11
Irkutsk RUS 147
Ivanovo RUS 150
Izhevsk RUS 252
Jevnaker NOR 162
Jyväskylä FIN 142
Kansk RUS 258
Karlstad SWE 84
Karuizawa JPN 34
Kazan RUS 241
Kemerovo RUS 237
Khabarovsk RUS 256
Kirov RUS 75
Kitami JPN 172
Kolomna RUS 101
Kongsberg NOR 92
Kongsvinger NOR 127
Koriyama JPN 124
Kostanaj KAZ 254
Krasnoyarsk RUS 227
Kristiansund NOR 205
Kristinehamm SWE 168
Kushiro JPN 91
Kvam-Norheimsund NOR 188
København DEN 36
Lake Placid USA 2
Larvik NOR 49
Leeuwarden NED 255
Leppävirta FIN 189
Lesnoj RUS 242
Losser NED 223
Lubin POL 122
Lærdal NOR 208
Matsubarako JPN 133
Medeu KAZ 13
Milwaukee USA 3
Minsk BLR 96
Monchegorsk RUS 216
Moose Jaw CAN 239
Morioka JPN 81
Moscow RUS 83
Motala SWE 97
München GER 62
Murmansk RUS 234
Murom RUS 179
Nagano JPN 7
Narvik NOR 144
Nemuro JPN 243
Nijmegen NED 82
Nikko JPN 61
Nizhny Novgorod RUS 86
Norheimsund NOR 231
Notodden NOR 266
Novocheboksarsk RUS 246
Obihiro JPN 90
Okaya JPN 143
Olenegorsk RUS 146
Omsk RUS 173
Örebro SWE 106
Oslo - Frogner NOR 192
Oslo - Valle Hovin NOR 37
Östersund SWE 197
Ottawa CAN 137
Oulu FIN 109
Perm RUS 148
Pori FIN 108
Prince George CAN 250
Pujon PRK 48
Qiqihar CHN 140
Quebec City CAN 6
Regina CAN 202
Richmond CAN 159
Roseville USA 4
Rotterdam NED 265
Saint Petersburg RUS 257
Sala SWE 164
Salt Lake City USA 1
Samjion PRK 156
Sand NOR 165
Sandefjord NOR 194
Sandviken SWE 187
Sanok POL 18
Sapporo JPN 50
Saratov RUS 232
Saskatoon CAN 182
Sault Sainte Marie CAN 185
Seinäjoki FIN 77
Selenginsk RUS 270
Seoul KOR 56
Severouralsk RUS 235
Seversk RUS 260
Shenyang CHN 95
Shostka UKR 230
Shushenskoe RUS 269
Skien NOR 73
Skjervøy NOR 217
Skutskär SWE 264
Sochi RUS 226
Sollentuna SWE 158
Sortavala RUS 253
St. Moritz SUI 44
Stange NOR 180
Stavanger NOR 191
Stockholm SWE 21
Stord NOR 136
Studnice u Hlinsko CZE 161
Sundsvall SWE 103
Syktyvkar RUS 268
Tambov RUS 251
Tampere FIN 170
Tierra del Fuego ARG 174
Tilburg NED 186
Tomakomai JPN 55
Tomaszów-Mazowiecki POL 58
Torino ITA 93
Trollhättan SWE 138
Tromsø NOR 110
Trondheim-Leangen NOR 131
Tula RUS 249
Tynset NOR 145
Tønsberg NOR 112
Ulaanbaatar MGL 46
Uppsala SWE 105
Urumqi CHN 201
Ushuaia ARG 152
Ust-Ishim RUS 248
Utrecht NED 38
Valkeakoski FIN 169
Västerås SWE 184
Viljandi EST 240
Vologda RUS 238
Wangqing CHN 236
Warsaw POL 71
Weiteveen NED 220
Whitehorse CAN 114
Winnipeg CAN 135
Wirdum NED 193
Yamagata JPN 123
Yatsugatake JPN 139
Zakopane POL 128
Žďár nad Sázavou CZE 199
Zenderen NED 221
Zoetermeer NED 225
Zürich SUI 120

XML

Element Description
competition

The list of competitions

Attributes

  • track - track ID
  • season - season start year
competitionThe competition ID
nameThe competition's name
startdateThe competition's start date (YYYY-MM-DD)
enddateThe competition's end date (YYYY-MM-DD)
linkURL for the link to the competition results on SpeedskatingResults.com

Example

API Query: http://speedskatingresults.com/api/xml/track_competitions?track=203&season=2012

<?xml version="1.0" encoding="utf-8" ?>
<competitions track="203" season="2012">
 <competition>
  <id>8745</id>
  <name>Constitution Day Cup</name>
  <startdate>2012-08-30</startdate>
  <enddate>2012-08-31</enddate>
  <link>http://speedskatingresults.com/index.php?p=2&e=8745</link>
 </competition>
 <competition>
  <id>8742</id>
  <name>Test Event</name>
  <startdate>2012-08-23</startdate>
  <enddate>2012-08-23</enddate>
  <link>http://speedskatingresults.com/index.php?p=2&e=8742</link>
 </competition>
 <competition>
  <id>8738</id>
  <name>Bikchantaeva Cup</name>
  <startdate>2012-08-04</startdate>
  <enddate>2012-08-04</enddate>
  <link>http://speedskatingresults.com/index.php?p=2&e=8738</link>
 </competition>
</competitions>

JSON

Key Description
track track ID
season season start year
competitions The list of competitions
idThe competition ID
nameThe competition's name
startdateThe competition's start date (YYYY-MM-DD)
enddateThe competition's end date (YYYY-MM-DD)
linkURL for the link to the competition results on SpeedskatingResults.com

Example

API Query: http://speedskatingresults.com/api/json/track_competitions?track=203&season=2012

{
  "track":203, "season":2012,
  "competitions":[
    {"id":10628, "name":"Spartakiada", "startdate":"2013-03-27", "enddate":"2013-03-29", "link":"http://speedskatingresults.com/index.php?p=2&e=10628"},
    {"id":10522, "name":"Open Championship - Sports School No. 2", "startdate":"2013-03-09", "enddate":"2013-03-10", "link":"http://speedskatingresults.com/index.php?p=2&e=10522"},
    {"id":10457, "name":"Spartakiada", "startdate":"2013-03-02", "enddate":"2013-03-03", "link":"http://speedskatingresults.com/index.php?p=2&e=10457"},
    {"id":10354, "name":"Test Start", "startdate":"2013-02-23", "enddate":"2013-02-23", "link":"http://speedskatingresults.com/index.php?p=2&e=10354"},
    {"id":10082, "name":"Kazakhstan -Junior Championships 2013", "startdate":"2013-02-02", "enddate":"2013-02-03", "link":"http://speedskatingresults.com/index.php?p=2&e=10082"},
    {"id":10081, "name":"Kazakhstan Cup", "startdate":"2013-02-02", "enddate":"2013-02-03", "link":"http://speedskatingresults.com/index.php?p=2&e=10081"},
    {"id":10080, "name":"2nd Masters International Allround Trophy", "startdate":"2013-02-02", "enddate":"2013-02-03", "link":"http://speedskatingresults.com/index.php?p=2&e=10080"},
    {"id":9915, "name":"National Federation Cup", "startdate":"2013-01-20", "enddate":"2013-01-20", "link":"http://speedskatingresults.com/index.php?p=2&e=9915"},
    {"id":9333, "name":"Kazakhstan Cup", "startdate":"2012-12-08", "enddate":"2012-12-09", "link":"http://speedskatingresults.com/index.php?p=2&e=9333"},
    {"id":9284, "name":"Out of Competition", "startdate":"2012-12-01", "enddate":"2012-12-01", "link":"http://speedskatingresults.com/index.php?p=2&e=9284"},
    {"id":9225, "name":"Essent ISU World Cup", "startdate":"2012-12-01", "enddate":"2012-12-02", "link":"http://speedskatingresults.com/index.php?p=2&e=9225"},
    {"id":8955, "name":"Kazakhstan - Single Distances Championships 2012", "startdate":"2012-11-02", "enddate":"2012-11-04", "link":"http://speedskatingresults.com/index.php?p=2&e=8955"},
    {"id":8830, "name":"Kazakhstan Cup/International Season Opening", "startdate":"2012-10-20", "enddate":"2012-10-21", "link":"http://speedskatingresults.com/index.php?p=2&e=8830"},
    {"id":8745, "name":"Constitution Day Cup", "startdate":"2012-08-30", "enddate":"2012-08-31", "link":"http://speedskatingresults.com/index.php?p=2&e=8745"},
    {"id":8752, "name":"Test Event - 3000m", "startdate":"2012-08-23", "enddate":"2012-08-23", "link":"http://speedskatingresults.com/index.php?p=2&e=8752"},
    {"id":8742, "name":"Test Event", "startdate":"2012-08-23", "enddate":"2012-08-23", "link":"http://speedskatingresults.com/index.php?p=2&e=8742"},
    {"id":8738, "name":"Bikchantaeva Cup", "startdate":"2012-08-04", "enddate":"2012-08-04", "link":"http://speedskatingresults.com/index.php?p=2&e=8738"}
  ]
}

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.

Competition List Example Page (XML)

Competition List 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;}
    table.results {margin: 1em; border-collapse: collapse; }
    table.results td {padding: .2em .5em; }
    table.records td.name {width: 20em; font-weight: bold;}
    table.records td.date {width: 10em; text-align: right;}
    a {color: navy; text-decoration: none; font-weight: bold;}
    a:visited {font-weight: normal;}
    a:hover {color: crimson;}
  </style>
  <title>API Example - Track Results</title>
  <script type="text/javascript" src="jquery-1.7.2.min.js"></script>
  <script type="text/javascript">
  $(document).ready(function(){
    $.ajax({
      type: "GET",
      url: "http://speedskatingresults.com/api/xml/track_competitions.php",
      data: "track=3&season=2011",
      dataType: "xml",
      success: function(xml) {
        $(xml).find('competition').each(function() {
          var name = $(this).find('name').text();
          var startdate = $(this).find('startdate').text();
          var enddate = $(this).find('enddate').text();
          var link = $(this).find('link').text();
          $('<tr></tr>').html('<td class="name"><a href="'+link+'">'+name+
            '</a></td><td class="date">'+startdate+
            '</td><td class="date">'+enddate+'</td>').appendTo('#events');
        });
      }
    });
  });
  </script>
</head>
<body>
  <h1>Milwaukee (USA) - Results 2011/2012</h1>
  <table id="events" class="results">
  </table>
  <p>Results from <a href="http://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: .9em;}
    table.results {margin: 1em; border-collapse: collapse; }
    table.results td {padding: .2em .5em; }
    table.records td.name {width: 20em; font-weight: bold;}
    table.records td.date {width: 10em; text-align: right;}
    a {color: navy; text-decoration: none; font-weight: bold;}
    a:visited {font-weight: normal;}
    a:hover {color: crimson;}
  </style>
  <title>API Example - Track Results</title>
  <script type="text/javascript" src="jquery-1.7.2.min.js"></script>
  <script type="text/javascript">
  $(document).ready(function(){
    $.ajax({
      type: "GET",
      url: "http://speedskatingresults.com/api/json/track_competitions.php",
      data: "track=3&season=2011",
      dataType: "json",
      success: function(data) {
        data.competitions.forEach(function(c) {
          $('<tr></tr>').html('<td class="name"><a href="'+c.link+'">'+c.name+
            '</a></td><td class="date">'+c.startdate+
            '</td><td class="date">'+c.enddate+'</td>').appendTo('#events');
        });
      }
    });
  });
  </script>
</head>
<body>
  <h1>Milwaukee (USA) - Results 2011/2012</h1>
  <table id="events" class="results">
  </table>
  <p>Results from <a href="http://speedskatingresults.com">SpeedskatingResults.com</a></p>
</body>
</html>