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_rankings

Returns all matches (and related events) that belong to a season, round or match

Request URL

https://dsg-api.com/clients/{client_name}/soccer/get_rankings?ev=goals&type=season&id={season_id}&cat=people&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

aggr

string

value is either "sum" or "avg"

authkey

string Required

client authentification key

cat

string

category filter, valid values are "people" and "team"

client

string Required

unique client ID

string Required

defines which stats to display. full list listed in API output by calling without ev= parameter

ftype

string

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

int Required

object id to return

lang

string

two-character language code, defaults to 'en'

rounds

string

list of rounds (comma-seperated) to filter the rankings by those rounds.

type

string Required

one of ‘season’ or ‘round’ or ‘competition’ to which the "id" refers

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 person

active

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

common_name

common name of the person

count

for _cum it will be in, for _avg it will be float as data type.

count_expulsion

number of expulsions (red cards and yellow-red cards)

count_yellow

number of yellow cards

first_name

first name of the person

last_name

last name of the person

nationality_area_id

unique identifier for an area

nationality_area_name

area name of peoples nationality

people_id

unique identifier for person

people_picture

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

position

position value

short_name

shortened name of the person

team_id

unique identifier of the team

team_name

current team name

team_short_name

short name of the team

team_tla_name

three-letter-acronym of the players team

stat❯

details about the stat type

name

name of the stat

type

stat type

team❯

details about the ranking team

area_id

unique identifier for an area

area_name

name of the area

count

for _cum it will be in, for _avg it will be float as data type.

position

position value

team_id

unique identifier of the team

team_logo

full path URL of team logo

team_name

current team name

team_short_name

short name of the team

team_tla_name

three-letter-acronym of the players team

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_rankings?ev=goals&type=season&id={season_id}&cat=people&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_rankings?ev=goals&type=season&id={season_id}&cat=people&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_rankings?ev=goals&type=season&id={season_id}&cat=people&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_rankings?ev=goals&type=season&id={season_id}&cat=people&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success