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
AdavereEST99
AkanJPN125
AlkmaarNED72
AltaNOR247
Åmli-DølemoNOR195
AmmerstolNED163
AmsterdamNED118
Amsterdam - OlympicNED244
AnchorageUSA183
ArendalNOR94
ArkhangelskRUS160
AsahikawaJPN153
AsamaJPN53
AskerNOR68
AssenNED88
AstanaKAZ203
BarnaulRUS116
BaselSUI119
Baselga di PinèITA17
BåstadNOR129
BergenNOR130
BerlinGER22
Berlin-WilmersdorfGER214
BjugnNOR117
BorlängeSWE245
BredaNED64
BudapestHUN16
CalgaryCAN5
ChangchunCHN102
ChelyabinskRUS57
Chelyabinsk - IngaRUS219
ChemnitzGER26
CherepoveczRUS149
ChinoJPN89
ChitaRUS206
CollalboITA10
CrimmitschauGER190
DaqingCHN259
DavosSUI20
Dawson CreekCAN200
Den HaagNED52
DeventerNED80
DivnogorskRUS115
DrammenNOR79
DresdenGER63
DrontenNED196
EdeNED176
EdmontonCAN261
EidsvollNOR167
EindhovenNED12
EkaterinburgRUS74
El CalafateARG154
EnaJPN126
EnschedeNED157
ErdenetMGL155
ErfurtGER14
EskilstunaSWE104
FalunSWE228
Fort Saint JohnCAN107
Fort St. JamesCAN181
FrankfurtGER87
FrösönSWE166
FujikyuJPN121
FukangCHN224
GangneungKOR262
GeithusNOR31
GeleenNED132
GjøvikNOR204
GolNOR33
GöteborgSWE29
GrefrathGER27
GroningenNED24
GrouNED229
HaaksbergenNED177
HaarlemNED54
HachinoheJPN111
HagaströmSWE134
HailarCHN215
HalifaxCAN198
HamarNOR8
HarbinCHN47
HarstadNOR67
HeerenveenNED9
HelsinkiFIN60
HengeloNED222
HolNOR171
HolmestrandNOR218
HoornNED100
HundorpNOR141
IkahoJPN59
InnsbruckAUT19
InzellGER11
IrkutskRUS147
IvanovoRUS150
IzhevskRUS252
JevnakerNOR162
JyväskyläFIN142
KanskRUS258
KarlstadSWE84
KaruizawaJPN34
KazanRUS241
KemerovoRUS237
KhabarovskRUS256
KirovRUS75
KitamiJPN172
KolomnaRUS101
KongsbergNOR92
KongsvingerNOR127
KoriyamaJPN124
KostanajKAZ254
KrasnoyarskRUS227
KristiansundNOR205
KristinehammSWE168
KushiroJPN91
Kvam-NorheimsundNOR188
KøbenhavnDEN36
Lake PlacidUSA2
LarvikNOR49
LeeuwardenNED255
LeppävirtaFIN189
LesnojRUS242
LosserNED223
LubinPOL122
LærdalNOR208
MatsubarakoJPN133
MedeuKAZ13
MilwaukeeUSA3
MinskBLR96
MonchegorskRUS216
Moose JawCAN239
MoriokaJPN81
MoscowRUS83
MotalaSWE97
MünchenGER62
MurmanskRUS234
MuromRUS179
NaganoJPN7
NarvikNOR144
NemuroJPN243
NijmegenNED82
NikkoJPN61
Nizhny NovgorodRUS86
NorheimsundNOR231
NovocheboksarskRUS246
ObihiroJPN90
OkayaJPN143
OlenegorskRUS146
OmskRUS173
ÖrebroSWE106
Oslo - FrognerNOR192
Oslo - Valle HovinNOR37
ÖstersundSWE197
OttawaCAN137
OuluFIN109
PermRUS148
PoriFIN108
Prince GeorgeCAN250
PujonPRK48
QiqiharCHN140
Quebec CityCAN6
ReginaCAN202
RichmondCAN159
RosevilleUSA4
Saint PetersburgRUS257
SalaSWE164
Salt Lake CityUSA1
SamjionPRK156
SandNOR165
SandefjordNOR194
SandvikenSWE187
SanokPOL18
SapporoJPN50
SaratovRUS232
SaskatoonCAN182
Sault Sainte MarieCAN185
SeinäjokiFIN77
SeoulKOR56
SeverouralskRUS235
SeverskRUS260
ShenyangCHN95
ShostkaUKR230
SkienNOR73
SkjervøyNOR217
SochiRUS226
SollentunaSWE158
SortavalaRUS253
StangeNOR180
StavangerNOR191
StockholmSWE21
StordNOR136
Studnice u HlinskoCZE161
SundsvallSWE103
TambovRUS251
TampereFIN170
Tierra del FuegoARG174
TilburgNED186
TomakomaiJPN55
Tomaszów-MazowieckiPOL58
TorinoITA93
TrollhättanSWE138
TromsøNOR110
Trondheim-LeangenNOR131
TulaRUS249
TynsetNOR145
TønsbergNOR112
UlaanbaatarMGL46
UppsalaSWE105
UrumqiCHN201
UshuaiaARG152
Ust-IshimRUS248
UtrechtNED38
ValkeakoskiFIN169
VästeråsSWE184
ViljandiEST240
VologdaRUS238
WangqingCHN236
WarsawPOL71
WeiteveenNED220
WhitehorseCAN114
WinnipegCAN135
WirdumNED193
YamagataJPN123
YatsugatakeJPN139
ZakopanePOL128
Žďár nad SázavouCZE199
ZenderenNED221
ZoetermeerNED225
ZürichSUI120

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 XML 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>
SpeedskatingResults.com on Facebook