DataSportsGroup API - Ice Hockey

Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com

v3 GET /ice_hockey/get_squad

Returns a list of players linked to a team.

Request URL

https://dsg-api.com/clients/{client_name}/ice_hockey/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}

API Threshold

10k calls per hour (2.78 calls per second)
This threshold applies to ALL your calls you do across the API.
Your number of calls get reset every hour at :00
If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)

Parameters

authkey

string Required

client authentification key

client

string Required

unique client ID

detailed

string Required

only 'yes' is valid, enables more details

ftype

string

changes feed type from XML to json (ftype=json or ftype=json_array)

lang

string

two-character language code, defaults to 'en'

picsize

string

one of 150x150, 50x50, 30x30 or 18x18 to get correct size of player picture.

team

int Required

team id to return

Nodes

datasportsgroup❯

details about the API version, sport, language and generation timestamp

generated_utc

UTC timestamp when the API output was generated

lang

language of the API call

sport

sport value

version

version of the API

method❯

details about the API function

method_id

unique ID of method

name

name of method

people❯

basic information about the squad member

age

current age of the person

common_name

common name of the person

country_of_birth

name of the country the person was born

country_of_birth_area_id

unique identifier for an area

date_of_death

death date of the person

first_name

first name of the person

gender

gender of the person ('male' or 'female')

height

height of person in centimeters

last_name

last name of the person

last_updated

When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.

membership_id

unique identifier for the membership

nationality

nationality of the person

nationality_area_id

unique identifier for an area

people_id

unique identifier for person

people_picture

full path URL of people headshot, size can be changed via the picsize parameter

place_of_birth

name of city the person was born

role

type of role ('player', 'coach' or 'assistant_coach', 'goalkeeper_coach', 'local_coach', 'scout', 'sporting director')

short_name

shortened name of the person

status

status of the player ('active', 'retired' or 'dead')

weight

weight of person in kilograms

people_extra❯

extra details about the person (hockey, ice hockey, water polo)

position

position value

shoots

shooting style of the player (left or right)

season_player_statistic❯

detailed player statistics per season (ice hockey)

assists

number of assists

blocks

number of blocks

faceoffs

number of faceoffs

faceoffs_won

number of faceoffs won

giveaways

number of giveaway

goalkeeper_ev_saves

number of goalkeeper saves (even)

goalkeeper_ev_shots_on_goal

value of the particular stat

goalkeeper_loss

number of goalkeeper losses

goalkeeper_power_play_saves

number of goalkeeper saves (power-play)

goalkeeper_power_play_shots_on_goal

value of the particular stat

goalkeeper_saves

number of goalkeeper saves

goalkeeper_short_handed_saves

value of the particular stat

goalkeeper_short_handed_shots_on_goal

value of the particular stat

goalkeeper_win

number of goalkeeper wins

goals

value of the particular stat

hits

value of the particular stat

original_name

competition name during this season

penalty_minutes

number of penalty minutes

plus_minus

total of plus minus

points

value of the particular stat

power_play_assists

value of the particular stat

power_play_goals

number of power play goals

season_id

unique identifier for season

short_handed_assists

value of the particular stat

short_handed_goals

number of short-handed goals

shots_on_goal

value of the particular stat

takeaway

number of takeaways

time_played

number of seconds played

time_played_pp

number of seconds played (power-play)

time_played_sh

number of seconds played (short-handed)

title

title of season

season_player_statistic_avg❯

detailed average player statistics per season (ice hockey)

assists

number of assists

blocks

average blocks made

faceoffs

average of faceoffs

faceoffs_won

average of faceoffs won

giveaways

average of giveaway

goalkeeper_ev_saves

average of goalkeeper saves (even)

goalkeeper_ev_shots_on_goal

value of the particular stat

goalkeeper_loss

average of goalkeeper losses

goalkeeper_power_play_saves

average of goalkeeper saves (power-play)

goalkeeper_power_play_shots_on_goal

value of the particular stat

goalkeeper_saves

average of goalkeeper saves

goalkeeper_short_handed_saves

value of the particular stat

goalkeeper_short_handed_shots_on_goal

value of the particular stat

goalkeeper_win

average of goalkeeper wins

goals_against

number of goals against in the particular match

hits

value of the particular stat

original_name

competition name during this season

penalty_minutes

average of penalty minutes

plus_minus

average of plus minus

points

average points made

power_play_assists

value of the particular stat

power_play_goals

value of the particular stat

season_id

unique identifier for season

short_handed_assists

value of the particular stat

short_handed_goals

value of the particular stat

shots_on_goal

value of the particular stat

takeaways

average of takeaways

time_played

average of seconds played

time_played_pp

average of seconds played (power-play)

time_played_sh

average of seconds played (short-handed)

title

title of season

season_statistic❯

season player statistics (ice hockey)

appearances

value of the particular stat

assists

number of assists

competition_name

name of the competition

comp_area_id

unique identifier for competition area

comp_format

competition format to filter out leagues or cups

goals

value of the particular stat

last_updated

When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.

original_name

competition name during this season

penalty_minutes

number of penalty minutes

points

value of the particular stat

power_play_goals

number of power play goals

season_id

unique identifier for season

short_handed_goals

number of short-handed goals

start_date

start date, format 'yyyy-mm-dd'

title

title of season

social_media❯

details about the social media channels

esea

ESEA Profile URL

esl_gaming

ESL Profile URL

facebook

facebook channel URL

faceit

Faceit Profile URL

instagram

instagram channel URL

reddit channel URL

steamid

steam ID channel URL

strava

strava Profile URL

tiktok

Tiktok Profile URL

twitch

Twitch channel URL

twitter

twitter channel URL

vk channel URL

website

official website address (URL)

youtube

youtube channel URL

team❯

details about a team

area_id

unique identifier for an area

area_name

name of the area

discipline_id

unique identifier of the discipline

discipline_name

name of the discipline

gender

gender of the team ('male', 'male youth', 'female' or 'female youth')

last_updated

When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.

short_name

shortened name of the person

status

the current status of the team ('active' or 'defunct')

team_id

unique identifier of the team

team_name

current team name

title

title of season

tla_name

three letter acronym for this team

type

determines the type of team ('national' or 'club' or 'selection')

Response Headers

200

Success

401

Unauthorized

429

Too Many Requests

Code Samples

PHP
Curl
Python
VB.NET

<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/ice_hockey/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);?>

curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/ice_hockey/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}"

Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/ice_hockey/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module

response = requests.get("https://dsg-api.com/clients/{client_name}/ice_hockey/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success