API - TopN List

Retrieve the top N skaters or times for a season.

URL

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

Parameters

Name Description
gender

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

Season to retrieve (optional)

The start year of the season (e.g. 2023 for 2023/2024). Defaults to the current season if not specified
distance

Distance (optional)

Specify a 100, 200, 300, 400, 500, 700, 1000, 1500, 3000, 5000 or 10000. Defaults to 500 if not specified.
skater

TopN skaters or times? (optional)

Specify y to retrieve the topN skaters (only a skater's best time will be present) or n to retrieve the topN times (skaters can appear multiple times).

Defaults to topN skaters if not specified.
max

Maximum number of results (1..500) (optional)

Defaults to 20 if not specified.
country

Limit to skaters from a specific country (optional)

Specify a country's 3-character IOC code.

The country and track parameters cannot be specified in the same request.
track

Limit to results from a specific track (optional)

Specify a track ID (see the table below).

The country and track parameters cannot be specified in the same request.
age

Limit results to skaters in a specific age category (optional)

Specify an age category from the table below.

Track IDs

TrackCountryId
Adavere EST 99
Akan JPN 125
Alkmaar NED 72
Almaty KAZ 13
Alta NOR 247
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
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
Båstad NOR 129
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
Grefrath GER 27
Groningen NED 24
Grou NED 229
Gävle SWE 307
Göteborg - Ishall SWE 298
Göteborg - Skrinnarhall SWE 29
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
Murmansk RUS 234
Murom RUS 179
München GER 62
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
Oslo - Frogner NOR 192
Oslo - Valle Hovin NOR 37
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
Viljandi EST 240
Vologda RUS 238
Västerås SWE 184
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
Zenderen NED 221
Zerenda KAZ 278
Zlatoust RUS 295
Zoetermeer NED 225
Zürich SUI 120
Åmli-Dølemo NOR 195
Örebro SWE 106
Östersund SWE 197
Žďár nad Sázavou CZE 199

Age Categories

Category Description
Y, YA, YB, YC, YD, YE, YF Youth
C, C1, C2 Junior C
B, B1, B2 Junior B
A, A1, A2 Junior A
JR Juniors A, B and C
N, N1, N2, N3, N4 Neo-Seniors
SA Seniors
M, 30, 35 ... 90, 95, 00 Masters, specific age categories in 5 year increments

XML

Element Description
topn

The TopN collection

Attributes

  • season - season's start year
  • top - N value
  • distance - the distance
  • age - age class filter (if requested)
  • gender - "m" (male) or "f" (female)
  • country - country IOC code (if requested)
  • track - track name (if requested)
resultA result
rankRank in the TopN list
timeFinishing time
dateRace date (YYYY-MM-DD)
locationRace location
eventCompetition name
skaterThe record holder
idThe skater's ID
familynameThe skater's family name
givennameThe skater's given name
familynativeThe skater's family name in native language (if available)
givennativeThe skater's given name in native language (if available)
countryThe skater's IOC country code

Example

API Query: https://speedskatingresults.com/api/xml/topn?gender=f&season=2023&distance=500&country=6&max=3

<?xml version="1.0" encoding="utf-8" ?>
<topn season="2023" top="3" distance="500m" gender="f" country="CAN">
  <result>
    <rank>1</rank>
    <time>37,93</time>
    <skater>
      <id>29989</id>
      <familyname>Hiller</familyname>
      <givenname>Carolina</givenname>
      <country>CAN</country>
    </skater>
    <date>2023-10-07</date>
    <location>Calgary (CAN)</location>
    <event>Canada - Long Track Championships 2024</event>
  </result>
  <result>
    <rank>2</rank>
    <time>38,45</time>
    <skater>
      <id>50945</id>
      <familyname>McDougall</familyname>
      <givenname>Brooklyn</givenname>
      <country>CAN</country>
    </skater>
    <date>2023-09-23</date>
    <location>Calgary (CAN)</location>
    <event>2023 Fall Classic</event>
  </result>
  <result>
    <rank>3</rank>
    <time>38,76</time>
    <skater>
      <id>5554</id>
      <familyname>Carruthers</familyname>
      <givenname>Heather</givenname>
      <country>CAN</country>
    </skater>
    <date>2023-12-01</date>
    <location>Calgary (CAN)</location>
    <event>2023 CanAm International</event>
  </result>
</topn>

JSON

Key Description
season The season's start year (e.g. 2023 = 2023/2024 season)
top N value
distanceRace distance
ageAge class filter (if requested)
gender"m" (male) or "f" (female)
countrycountry IOC code (if requested)
tracktrack name (if requested)
topn"The TopN collection
rankRank in the TopN list
timeFinishing time
dateRace date (YYYY-MM-DD)
locationRace location
eventCompetition name
skaterThe record holder
idThe skater's ID
familynameThe skater's family name
givennameThe skater's given name
familynativeThe skater's family name in native language (if available)
givennativeThe skater's given name in native language (if available)
countryThe skater's IOC country code

Example

API Query: https://speedskatingresults.com/api/json/topn?gender=m&season=2023&distance=500&max=3

{
  "season": 2023,
  "top": 3,
  "distance": "500m",
  "gender": "m",
  "topn": [
  {
    "rank": 1,
    "time": "34,40",
    "skater": {
    "id": 21522,
    "familyname": "Shinhama",
    "givenname": "Tatsuya",
    "familynative": "新濱",
    "givennative": "立也",
    "country": "JPN"
    },
    "date": "2023-10-20",
    "location": "Nagano (JPN)",
    "event": "Japan - Single Distances Championships 2024"
  },
  {
    "rank": 2,
    "time": "34,54",
    "skater": {
    "id": 6727,
    "familyname": "Dubreuil",
    "givenname": "Laurent",
    "country": "CAN"
    },
    "date": "2023-10-05",
    "location": "Calgary (CAN)",
    "event": "Canada - Long Track Championships 2024"
  },
  {
    "rank": 3,
    "time": "34,60",
    "skater": {
    "id": 21597,
    "familyname": "Scheperkamp",
    "givenname": "Merijn",
    "country": "NED"
    },
    "date": "2023-10-27",
    "location": "Heerenveen (NED)",
    "event": "World Cup Kwalificatietoernooi"
  }
  ]
}

Native Language Names