DataSportsGroup API - Tennis

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

v4 GET /tennis/get_matches

Returns all matches of a particular tournament

Request URL

https://dsg-api.com/clients/{client_name}/tennis/get_matches?type=season&id={season_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

age

string

unique identifier for an age group

authkey

string Required

client authentification key

client

string Required

unique client ID

discipline_id

int

unique identifier for a discipline

ftype

string

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

gender

string

unique identifier for a gender (male,female)

int Required

object id to return

lang

string

two-character language code, defaults to 'en'

team_id

int

use a team_id as value to filter the matches accordingly

type

string Required

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

Nodes

competition❯

details about competition

area_id

unique identifier for an area

area_name

name of the area

competition_id

unique identifier for a competition

format

competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)

gender

determines the gender of the competition (male or female)

last_updated

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

name

name of the competition

type

determines if a competition is between club teams (club) or national teams (international)

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

discipline❯

basic information about the discipline

discipline_id

unique identifier of the discipline

name

name of the discipline

type

type of discipline (contestant, contestant_team or team)

gender❯

details about the gender

age_group

defines the age group (senior,u23,u22,u21....)

value

gender type (male, female or mixed)

list❯

details about list type

aggregation_type

aggregation type (scores or wins)

unique identifier for a group if type = group, if type = playoff then for a playoff

last_updated

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

name

name of either a group or playoff

score_a

playoff score of team_a

score_b

playoff score of team_b

type

list type (regular, group or playoff)

winner_team_id

unique identifier for the winning team of the playoff

live❯

details about live game informations

game_point_a

game point of contestant/team A

game_point_b

game point of contestant/team B

game_serve

people_id of the serving contestant

match❯

details about the particular match

contestant_a1_common_name

common name of the contestant

contestant_a1_first_name

first name of the contestant

contestant_a1_id

unique identifier for the contestant

contestant_a1_last_name

last name of the contestant

contestant_a1_nationality_area_code

area code of contestants nationality

contestant_a1_nationality_area_id

unique area_id of the contestants nationality

contestant_a1_nationality_area_name

nationality of the contestant

contestant_a1_short_name

short name of the contestant

contestant_a2_common_name

common name of the contestant

contestant_a2_first_name

first name of the contestant

contestant_a2_id

unique identifier for the contestant

contestant_a2_last_name

last name of the contestant

contestant_a2_nationality_area_code

area code of contestants nationality

contestant_a2_nationality_area_id

unique area_id of the contestants nationality

contestant_a2_nationality_area_name

nationality of the contestant

contestant_a2_short_name

short name of the contestant

contestant_a_common_name

common name of the contestant

contestant_a_draw_position

darw position of the contestant

contestant_a_first_name

first name of the contestant

contestant_a_id

unique identifier for the contestant

contestant_a_last_name

last name of the contestant

contestant_a_nationality_area_code

area code of contestant_a nationality

contestant_a_nationality_area_id

unique area_id of the contestants nationality

contestant_a_nationality_area_name

nationality of the contestant

contestant_a_seeding

seeding of the contestant

contestant_a_short_name

short name of the contestant

contestant_b1_common_name

common name of the contestant

contestant_b1_first_name

first name of the contestant

contestant_b1_id

unique identifier for the contestant

contestant_b1_last_name

last name of the contestant

contestant_b1_nationality_area_code

area code of contestants nationality

contestant_b1_nationality_area_id

unique area_id of the contestants nationality

contestant_b1_nationality_area_name

nationality of the contestant

contestant_b1_short_name

short name of the contestant

contestant_b2_common_name

common name of the contestant

contestant_b2_first_name

first name of the contestant

contestant_b2_id

unique identifier for the contestant

contestant_b2_last_name

last name of the contestant

contestant_b2_nationality_area_code

area code of contestants nationality

contestant_b2_nationality_area_id

unique area_id of the contestants nationality

contestant_b2_nationality_area_name

nationality of the contestant

contestant_b2_short_name

short name of the contestant

contestant_b_common_name

common name of the contestant

contestant_b_draw_position

darw position of the contestant

contestant_b_first_name

first name of the contestant

contestant_b_id

unique identifier for the contestant

contestant_b_last_name

last name of the contestant

contestant_b_nationality_area_code

area code of contestants nationality

contestant_b_nationality_area_id

unique area_id of the contestants nationality

contestant_b_nationality_area_name

nationality of the contestant

contestant_b_seeding

seeding of the contestant

contestant_b_short_name

match name of the contestant

contestant_team_a_draw_position

darw position of the contestant team

contestant_team_a_id

unique identifier for the contestant team/double

contestant_team_a_seeding

seeding of the contestant team

contestant_team_b_draw_position

darw position of the contestant team

contestant_team_b_id

unique identifier for the contestant team/double

contestant_team_b_seeding

seeding of the contestant team

contestant_team_id

unique identifier for the contestant team/double

date

date of match, format 'yyyy-mm-dd' (CET)

date_utc

date of match, format 'yyyy-mm-dd' (UTC)

final_period

display the period in which the match finished.

last_updated

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

match_id

unique identifier of match

score_a

full-time score of team_a

score_b

full-time score of team_b

status

status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded, Break, Retired, Bye, No Contest, Disqualified, Tech Knockout, Knockout, Draw, Submission) + (Cricket-specific = No Result, Tea, Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)

team_a_area_code

three-letter-acronym of the area where the home team origins

team_a_area_id

unique area_id for team_a

team_a_area_name

area name of home team origins county

team_a_id

unique team ID for team_a

team_a_logo

team logo URL

team_a_name

current name of team_a

team_a_original_name

the real name at the particular season (so can differ to current name)

team_a_short_name

short name of the home team

team_a_tla_name

three-letter-acronym of team_a

team_b_area_code

three-letter-acronym of the area where the home team origins

team_b_area_id

unique area_id for team_b

team_b_area_name

area name of away team origins county

team_b_id

unique team ID for team_b

team_b_logo

team logo URL

team_b_name

current name of team_b

team_b_original_name

the real name at the particular season (so can differ to current name)

team_b_short_name

short name of team_b

team_b_tla_name

three-letter-acronym of team_b

time

start time (CET), format 'hh:mm:ss'.

time_utc

start time (UTC), format 'hh:mm:ss'

venue_type

determines if the match is on neutral ground or on home/away basis (home_away or neutral)

winner

determines the winner of match ('team_A','team_B','draw','yet unknown')

match_extra❯

extra informations about the specific match

duration

total duration of the match

game_point_a

game point of contestant/team A

game_point_b

game point of contestant/team B

game_serve

people_id of the serving contestant

playing_area

specific playing area within the venue

method❯

details about the API function

method_id

unique ID of method

name

name of method

period❯

details about periods of the match

score_a

period score of team_a

score_b

period score of team_b

type

three-letter-acronym of the period

period_stats❯

details about the period stats (tennis)

aces

value of the particular stat

break_points

value of the particular stat

break_points_against

value of the particular stat

break_points_converted

value of the particular stat

break_points_saved

value of the particular stat

double_faults

value of the particular stat

first_serve

value of the particular stat

first_serve_made

value of the particular stat

first_serve_points

value of the particular stat

first_serve_points_won

value of the particular stat

first_serve_return_points

value of the particular stat

first_serve_return_points_won

value of the particular stat

period_type

unique identifier for the specific period

return_games_played

value of the particular stat

return_rating

value of the particular stat

second_serve_points

value of the particular stat

second_serve_points_won

value of the particular stat

second_serve_return_points

value of the particular stat

second_serve_return_points_won

value of the particular stat

serve_rating

value of the particular stat

service_games_played

value of the particular stat

total_points

value of the particular stat

total_points_won

value of the particular stat

total_return_points

value of the particular stat

total_return_points_won

value of the particular stat

total_service_points

value of the particular stat

total_service_points_won

value of the particular stat

round❯

details about the round

end_date

end date, format 'yyyy-mm-dd'

end_date_utc

end date in UTC timezone, format 'yyyy-mm-dd'

end_time

end time, format 'HH:mm:ss'

end_time_utc

end time in UTC timezone, format 'HH:mm:ss'

last_updated

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

name

name of round

round_id

unique identifier of round

start_date

start date, format 'yyyy-mm-dd'

start_date_utc

start date in UTC timezone, format 'yyyy-mm-dd'.

start_time

start time, format 'HH:mm:ss'

start_time_utc

start time in UTC timezone, format 'HH:mm:ss'

type

determines if the round contains a table or a cup structure (knock-out)

round_extra❯

extra round details

medal_round

indicates if medals are awarded in this round

status

status of the round (Scheduled,Live,Played,Postponed,Cancelled,Break)

season❯

details about the season

end_date

end date, format 'yyyy-mm-dd'

last_updated

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

logo

full path URL of logo for particular season

original_name

competition name during this season

season_id

unique identifier for season

start_date

start date, format 'yyyy-mm-dd'

title

title of season

stat❯

player stats of the match for a particular contestant (tennis)

aces

value of the particular stat

break_points

value of the particular stat

break_points_against

value of the particular stat

break_points_converted

value of the particular stat

break_points_saved

value of the particular stat

double_faults

value of the particular stat

first_serve

value of the particular stat

first_serve_made

value of the particular stat

first_serve_points

value of the particular stat

first_serve_points_won

value of the particular stat

first_serve_return_points

value of the particular stat

first_serve_return_points_won

value of the particular stat

people_id

unique identifier for person

return_games_played

value of the particular stat

return_rating

value of the particular stat

second_serve_points

value of the particular stat

second_serve_points_won

value of the particular stat

second_serve_return_points

value of the particular stat

second_serve_return_points_won

value of the particular stat

serve_rating

value of the particular stat

service_games_played

value of the particular stat

total_points

value of the particular stat

total_points_won

value of the particular stat

total_return_points

value of the particular stat

total_return_points_won

value of the particular stat

total_service_points

value of the particular stat

total_service_points_won

value of the particular stat

tour❯

details about the tour

gender

gender of the tour

name

name of the particular tour

tour_id

unique tour identifier

tour_type

defines if the tournament is part of a tour or not. If not then value "non-tour"

tour_season❯

details about a tour season

logo

full path URL of logo for particular tour_season

name

name of the tour_season

title

title of the particular tour season

tour_season_id

unique identifier of a tour season

venue❯

basic details about the venue

venue_area_id

unique identifier for an area

venue_area_name

name of the area

venue_city

city where the venue is based

venue_id

unique identifier of the venue

venue_name

current name of the venue

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}/tennis/get_matches?type=season&id={season_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}/tennis/get_matches?type=season&id={season_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}/tennis/get_matches?type=season&id={season_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}/tennis/get_matches?type=season&id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success