DataSportsGroup API - Soccer

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

v3 GET /soccer/get_squad

Returns a list of players linked to a team.

Request URL

https://dsg-api.com/clients/{client_name}/soccer/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'

node_hide

string

comma seperated list of nodes you want to hide. valid nodes = season_statistic, season_player_statistic, season_player_statistic_avg, caps, current_club

picsize

string

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

season

int

season_id to get player statistics for the particular season

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 (soccer, rugby, australian football)

foot

Best/preferred foot of the player ('both', 'left' or 'right')

position

position value

season_player_statistic❯

detailed player statistics per season (soccer)

aerials_lost

number of lost aerials

aerials_won

number of won aerials

att_freekick_goal

number of freekick goals

ball_recovery

number of ball recoveries

big_chance_created

number of big chances created

blocked_cross

number of blocked crosses

blocked_scoring_att

number of blocked shots

corners

number of corners

crosses

number of crosses

duel_lost

number of lost duels

duel_won

number of duels won

error_lead_to_goal

number of errors which lead to a goal

error_lead_to_shot

number of errors who lead to a shot

fouled

number of fouls received

fouls

value of the particular stat

hit_woodwork

number of times a shot hit the woodwork

interceptions

number of interceptions made

key_passes

number of key passes

last_man_tackle

number of last man tackles

long_balls

number of long balls

offsides

number of offsides made

original_name

competition name during this season

passes

number of passes attempted

passes_completed

number of passes completed

penalty_conceded

number of penalties conceded

penalty_won

number of penaltys drawn

poss_lost_all

number of times possession was lost

saves

value of the particular stat

season_id

unique identifier for season

second_goal_assist

number of second goal assists

shots_on_target

number of shots on target

shots_total

number of total shots

tackles

number of tackles attempted

tackles_won

number of tackles won

title

title of season

total_clearance

number of total clearances

total_final_third_passes

number of final third passes

touches

number of touches

touches_in_opp_box

number of touches in the opposite box

won_contest

number of contests won

won_corners

number of corners won

season_player_statistic_avg❯

detailed average player statistics per season (soccer)

aerials_lost

average of lost aerials

aerials_won

average of won aerials

att_freekick_goal

average of freekick goals

ball_recovery

average of ball recoveries

big_chance_created

average of big chances created

blocked_cross

average of blocked crosses

blocked_scoring_att

average of blocked shots

corners

number of corners

crosses

average of crosses

duel_lost

average of lost duels

duel_won

average of duels won

error_lead_to_goal

average of errors which lead to a goal

error_lead_to_shot

average of errors who lead to a shot

fouled

average of fouls received

fouls

average of fouls made

hit_woodwork

average of times a shot hit the woodwork

interceptions

average of interceptions made

key_passes

average of key passes

last_man_tackle

average of last man tackles

long_balls

average of long balls

offsides

average of offsides made

original_name

competition name during this season

passes

average of passes attempted

passes_completed

average of passes completed

penalty_conceded

average of penalties conceded

penalty_won

average of penaltys drawn

poss_lost_all

average of times possession was lost

saves

average of saves

season_id

unique identifier for season

second_goal_assist

average of second goal assists

shots_on_target

average of shots on target

shots_total

average of total shots

tackles

average of tackles attempted

tackles_won

average of tackles won

title

title of season

total_clearance

average of total clearances

total_final_third_passes

average of final third passes

touches

average of touches

touches_in_opp_box

average of touches in the opposite box

won_contest

average of contests won

won_corners

average of corners won

season_statistic❯

season player statistics (soccer)

appearances

value of the particular stat

assists

number of assists

clean_sheets

number of clean sheets

goals

value of the particular stat

last_updated

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

minutes_played

number of played minutes

original_name

competition name during this season

red_cards

value of the particular stat

saves

value of the particular stat

season_id

unique identifier for season

start_date

start date, format 'yyyy-mm-dd'

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

title

title of season

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

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}/soccer/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}/soccer/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}/soccer/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}/soccer/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success