API - Skater ID Lookup

Look up a skater's ID.

URL

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

Parameters

Name	Description
familyname	Skater's family name (optional). A starting substring may be specified instead of the entire name.
givenname	Skater's given name (optional). A starting substring may be specified instead of the entire name.
country	A three character IOC country code (optional).
gender	The skater's gender: m (male) or f (female) (optional).

While all four parameters are optional, a value must be specified for at least one of them.

XML

Element	Description
skaters	The list of skaters matching the search criteria. A maximum of 20 skaters will be returned.
skater	A skater matching the search criteria
id	The skater's ID
familyname	The skater's family name
givenname	The skater's given name
country	IOC country code
gender	m (male) or f (female)
category	The skater's age category as of the current date. If the skater's date of birth is not in the SpeedskatingResults.com database, this element will not be present.

Example

API Query: https://speedskatingresults.com/api/xml/skater_lookup?familyname=cod&country=CAN

<?xml version="1.0" encoding="utf-8" ?>
<skaters>
  <skater>
    <id>1714</id>
    <familyname>Coder</familyname>
    <givenname>Amanda</givenname>
    <country>CAN</country>
    <gender>f</gender>
    <category>N3</category>
  </skater>
  <skater>
    <id>538</id>
    <familyname>Coder</familyname>
    <givenname>Stacie</givenname>
    <country>CAN</country>
    <gender>f</gender>
    <category>SA</category>
  </skater>
  <skater>
    <id>36227</id>
    <familyname>Coderre</familyname>
    <givenname>Paul</givenname>
    <country>CAN</country>
    <gender>m</gender>
  </skater>
</skaters>

JSON

Key	Description
skaters	The list of skaters matching the search criteria. A maximum of 10 skaters will be returned.
id	The skater's ID
familyname	The skater's family name
givenname	The skater's given name
country	IOC country code
gender	m (male) or f (female)
category	The skater's age category as of the current date. If the skater's date of birth is not in the SpeedskatingResults.com database, this key will not be present.

Example

API Query: https://speedskatingresults.com/api/json/skater_lookup?familyname=cod&country=CAN

{
  "skaters":[
    {"id":1714, "familyname":"Coder", "givenname":"Amanda", "country":"CAN", "gender":"f", "category":"SA"},
    {"id":538, "familyname":"Coder", "givenname":"Stacie", "country":"CAN", "gender":"f", "category":"SA"},
    {"id":36227, "familyname":"Coderre", "givenname":"Paul", "country":"CAN", "gender":"m", "category":"B1"}
  ]
}

Native Language Names