API - Competition List (Track)

Get a list of competitions held at a track.

URL

Type URL
XML https://speedskatingresults.com/api/xml/track_competitions.php
JSON https://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
Almaty KAZ 13
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-Dinamo RUS 272
Arkhangelsk-Trud RUS 160
Arsenev RUS 280
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
Beijing-Erqi CHN 283
Beijing-National CHN 290
Bergen NOR 130
Berlin GER 22
Berlin-Wilmersdorf GER 214
Birobidzhan RUS 275
Bjugn NOR 117
Bogdanovich RUS 304
Borlänge SWE 245
Breda NED 64
Budapest HUN 16
Calgary CAN 5
Changchun CHN 102
Cheboksary RUS 299
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 St. James CAN 181
Fort St. John CAN 107
Frankfurt GER 87
Frösön SWE 166
Fujiyoshida 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 - Ishall SWE 298
Göteborg - Skrinnarhall SWE 29
Grefrath GER 27
Groningen NED 24
Grou NED 229
Haaksbergen NED 177
Haarlem NED 54
Hachinohe - YS Arena JPN 284
Hachinohe-Piping 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
Innsbruck AUT 19
Inzell GER 11
Irkutsk-Baikal RUS 287
Irkutsk-Trud 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
Kirovo-Chepeczk RUS 151
Kitami JPN 172
Kolomna RUS 101
Kolosovka RUS 276
Kongsberg NOR 92
Kongsvinger NOR 127
Koriyama JPN 124
Kostanaj KAZ 254
Koumi JPN 133
Krasnoturinsk RUS 297
Krasnoyarsk RUS 227
Kristiansund NOR 205
Kristinehamn SWE 168
Kungur RUS 306
Kuopio FIN 285
Kushiro JPN 91
Kvam-Norheimsund NOR 188
København DEN 36
Lake Placid USA 2
Larvik NOR 49
Leeuwarden NED 255
Leh Ladakh IND 305
Leiden NED 301
Leppävirta FIN 189
Lesnoj RUS 242
Losser NED 223
Lubin POL 122
Lærdal NOR 208
Makinsk KAZ 277
Milwaukee USA 3
Minsk BLR 96
Minusinsk RUS 282
Monchegorsk RUS 216
Moose Jaw CAN 239
Morioka JPN 81
Moscow RUS 83
Moscow-Luzhniki RUS 293
Motala SWE 97
München GER 62
Murmansk RUS 234
Murom RUS 179
Nagano JPN 7
Nakashibetsu JPN 273
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
Novouralsk RUS 294
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 - Pateniemen FIN 302
Oulu - Raksila FIN 109
Perm - Dinamo RUS 300
Perm - Yunost RUS 148
Pijnacker NED 291
Pori FIN 108
Prince George CAN 250
Pujon PRK 48
Qiqihar CHN 140
Quebec City CAN 292
Quebec City-Boucher CAN 6
Red Deer CAN 274
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
Shhuchinsk KAZ 279
Shibukawa JPN 59
Shostka UKR 230
Shushenskoe RUS 269
Skien NOR 73
Skjervøy NOR 217
Skreia NOR 288
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
Tallinn EST 286
Tambov RUS 251
Tampere-Pyynikin FIN 170
Tampere-Sorsapuiston FIN 289
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
Yanji CHN 303
Yatsugatake JPN 139
Zakopane POL 128
Zarechnyj RUS 296
Žďár nad Sázavou CZE 199
Zenderen NED 221
Zerenda KAZ 278
Zlatoust RUS 295
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: https://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: https://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: "https://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="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: .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: "https://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="https://speedskatingresults.com">SpeedskatingResults.com</a></p>
</body>
</html>

Native Language Names