DataSportsGroup API - Soccer

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

v4 GET /soccer/get_peoples

Returns person informations and list of teams the person were member of.

Request URL

https://dsg-api.com/clients/{client_name}/soccer/get_peoples?id={people_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

ftype

string

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

int Required

player id to return

lang

string

two-character language code, defaults to 'en'

int

match limit for , max limit = 100

Nodes

coach_main_club_career❯

coach statistics in all club competitions

appearances

value of the particular stat

draws

number of draws

goals_against

value for total goals against

goals_for

value for total goals made

losses

number of losses

points

value for total points gained

points_avg

average points per match

red_cards

value of the particular stat

wins

number of wins

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

coach_main_national_team_career❯

coach statistics in all national team competitions

appearances

value of the particular stat

draws

number of draws

goals_against

value for total goals against

goals_for

value for total goals made

losses

number of losses

points

value for total points gained

points_avg

average points per match

red_cards

value of the particular stat

wins

number of wins

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

coach_youth_club_career❯

coach statistics in all youth club competitions (soccer)

appearances

value of the particular stat

draws

number of draws

goals_against

value for total goals against

goals_for

value for total goals made

losses

number of losses

points

value for total points gained

points_avg

average points per match

red_cards

value of the particular stat

wins

number of wins

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

coach_youth_national_team_career❯

coach statistics in all youth club competitions (soccer)

appearances

value of the particular stat

draws

number of draws

goals_against

value for total goals against

goals_for

value for total goals made

losses

number of losses

points

value for total points gained

points_avg

average points per match

red_cards

value of the particular stat

wins

number of wins

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

competition_statistic❯

soccer player statistics per competition

appearances

value of the particular stat

assists

number of assists

competition_id

unique identifier for a competition

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

minutes_played

number of played minutes

red_cards

value of the particular stat

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

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

main_club_career❯

soccer player statistics in all club competitions

appearances

value of the particular stat

assists

number of assists

goals

value of the particular stat

minutes_played

number of played minutes

red_cards

value of the particular stat

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

main_national_team_career❯

soccer player statistics in all national team competitions

appearances

value of the particular stat

assists

number of assists

goals

value of the particular stat

minutes_played

number of played minutes

red_cards

value of the particular stat

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

membership❯

details about the membership (membership = relation between player and team)

active

Determines if person is still at the team (yes) or not (no).

end_date

end date of membership, format 'yyyy-mm-dd'

last_updated

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

membership_id

unique identifier for the membership

role

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

short_name

shortened name of the person

start_date

start date, format 'yyyy-mm-dd'

team_area_id

unique identifier for an area

team_area_name

area name of the team

team_id

unique identifier of the team

team_name

current team name

type

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

method❯

details about the API function

method_id

unique ID of method

name

name of method

people❯

basic information about the person

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.

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

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

referee_domestic_career❯

referee statistics in all club competitions

appearances

value of the particular stat

assitant_var

number of appearances as Assistant VAR

fourth_official

number of appearances as 4th Official

linesmen

number of appearances as linesmen

penalties

number of penalties awarded

red_cards

value of the particular stat

var

number of appearances as VAR

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

referee_international_career❯

referee statistics in all national team competitions

appearances

value of the particular stat

assitant_var

number of appearances as Assistant VAR

fourth_official

number of appearances as 4th Official

linesmen

number of appearances as linesmen

penalties

number of penalties awarded

red_cards

value of the particular stat

var

number of appearances as VAR

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

season_statistic❯

player statistics per season (soccer)

appearances

value of the particular stat

assists

number of assists

assitant_var

number of appearances as Assistant VAR

competition_name

name of the competition

comp_area_id

unique identifier for competition area

comp_format

competition format to filter out leagues or cups

fourth_official

number of appearances as 4th Official

goals

value of the particular stat

last_updated

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

linesmen

number of appearances as linesmen

minutes_played

number of played minutes

original_name

competition name during this season

penalties

number of penalties awarded

red_cards

value of the particular stat

season_id

unique identifier for season

shirtnumber

shirtnumber value

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

var

number of appearances as VAR

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

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

youth_club_career❯

player statistics in all youth club competitions (soccer)

appearances

value of the particular stat

assists

number of assists

goals

value of the particular stat

minutes_played

number of played minutes

red_cards

value of the particular stat

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

youth_national_team_career❯

player statistics in all youth club competitions (soccer)

appearances

value of the particular stat

assists

number of assists

goals

value of the particular stat

minutes_played

number of played minutes

red_cards

value of the particular stat

substitutes_in

number of substitutes in

substitutes_out

number of substitutes out

subs_on_bench

number of subs on bench

yellow_cards

number of yellow cards

yellow_red_cards

number of yellow-red cards

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_peoples?id={people_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_peoples?id={people_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_peoples?id={people_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_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success