Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /lol/get_matches
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/lol/get_matches?type={type}&id={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
detailed
string
only 'yes' is valid to display additional match details
discipline_id
int
unique identifier for a discipline
enddate
string
end date, format 'yyyy-mm-dd' (requires startdate to take effect)
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
gameweek
int
gameweek value to get matches from
gender
string
unique identifier for a gender (male,female)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
picsize
string
one of 200x200, 100x100, 50x50, 30x30 or 18x18 to get correct size of club logo.
pstats
string
'yes' and 'no' are valid, enables/disables player stat nodes
startdate
string
start date, format 'yyyy-mm-dd' (requires enddate to take effect)
team_id
int
use a team_id as value to filter the matches accordingly
timestamp
string
'yyyy-mm-dd hh:mm:ss', will display only events after this timestamp
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
items
details about the selected items for the particular map
item_1
item_id for the 1st selected item
item_2
item_id for the 2nd selected item
item_3
item_id for the 3rd selected item
item_4
item_id for the 4th selected item
item_5
item_id for the 5th selected item
item_6
item_id for the 6th selected item
item_7
item_id for the 7th selected item
lineup
details of participating player in the particular match
common_name
common name of the person
event_id
unique identifier of a player event
first_name
first name of the person
last_name
last name of the person
nationality
nationality of the person
people_id
unique identifier for person
position
position value
short_name
shortened name of the person
team_id
unique identifier of the team
team_name
current team name
type
type of event (depends on the parent node)
lineup_game_x
details of role and position for the particular map
champion_id
unique identifier for the selected champion
champion_name
name of the selected champion
lane
player lane for the particular match
role
player role for the particular match
spell_1_id
unique identifier for the selected spell
spell_2_id
unique identifier for the selected spell
list
details about list type
aggregation_type
aggregation type (scores or wins)
id
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
masteries
details about the selected masteries for the particular map
mastery_1
mastery_id of the first selected mastery
mastery_10
mastery_id of the 10th selected mastery
mastery_10_rank
rank for the selected mastery
mastery_11
mastery_id of the 11th selected mastery
mastery_11_rank
rank for the selected mastery
mastery_1_rank
rank for the selected mastery
mastery_2
mastery_id of the second selected mastery
mastery_2_rank
rank for the selected mastery
mastery_3
mastery_id of the 3rd selected mastery
mastery_3_rank
rank for the selected mastery
mastery_4
mastery_id of the 4th selected mastery
mastery_4_rank
rank for the selected mastery
mastery_5
mastery_id of the 5th selected mastery
mastery_5_rank
rank for the selected mastery
mastery_6
mastery_id of the 6th selected mastery
mastery_6_rank
rank for the selected mastery
mastery_7
mastery_id of the 7th selected mastery
mastery_7_rank
rank for the selected mastery
mastery_8
mastery_id of the 8th selected mastery
mastery_8_rank
rank for the selected mastery
mastery_9
mastery_id of the 9th selected mastery
mastery_9_rank
rank for the selected mastery
match
details about the match
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')
method
details about the API function
method_id
unique ID of method
name
name of method
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 information
current_gameweek
displays the gameweek of nearest match to today
medal_round
indicates if medals are awarded in this round
status
status of the round (Scheduled,Live,Played,Postponed,Cancelled,Break)
total_gameweek
displays the total of gameweeks for this round
runes
details about the selected runes for the particular map
rune_1
rune_id for the 1st selected item
rune_1_rank
rank for the selected rune
rune_2
rune_id for the 2nd selected item
rune_2_rank
rank for the selected rune
rune_3
rune_id for the 3rd selected item
rune_3_rank
rank for the selected rune
rune_4
rune_id for the 4th selected item
rune_4_rank
rank for the selected rune
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
stats
detailed stats for the particular map
assists
number of assists
champ_level
champion Level
combat_player_score
combat player score
deaths
number of deaths
double_kills
number of double kills
first_blood_assist
in case first blood assist then value = true
first_blood_kill
in case first blood kill then value = true
first_inhibitor_assist
in case first inhibitor assist then value = true
first_inhibitor_kill
in case first inhibitor kill then value = true
first_tower_assist
in case first twoer assist then value = true
first_tower_kill
in case first tower kill then value = true
gold earned
total gold earned
gold_spent
total gold spent
inhibitor_kills
total inhibitor kills
killing_spree
number of killing sprees
kills
number of kills
largest_critical_strike
largest critical strike
largest_killing_spree
largest killing spree
largest_multi_kill
largest multi kill
longest_time_spent_living
longest time spent alive (in seconds)
magical_damage_taken
magical damage taken
magic_damage_dealt
magic damage dealt
magic_damage_dealt_to_champions
magic damage dealt to champions
neutral_minions_killed
total neutral minions killed
neutral_minions_killed_enemy_jungle
total neutral minions killed enemy jungle
neutral_minions_killed_team_jungle
total neutral minions killed team junle
objective_player_score
objective player score
penta_kills
number of penta kills
physical_damage_dealt
physical damage dealt
physical_damage_dealt_to_champions
physical damage dealt to champions
physical_damage_taken
physical damage taken
quadra_kills
number of quadra kills
sight_wards_bought_in_game
number of sight wards bough in game
total_damage_dealt
total damage dealt
total_damage_dealt_to_champions
total damage dealt to champions
total_damage_taken
total damage taken
total_heal
total heal
total_minions_killed
total total minions killed
total_player_score
total player score
total_score_rank
total score rank
total_time_crowd_control_dealt
total time crowd control dealt
total_units_healed
total units healed
triple_kills
number of triple kills
true_damage_dealt
true damage dealt
true_damage_dealt_to_champions
true damage dealt to champions
true_damage_taken
true damage taken
turret_kills
total turret kills
unreal_kills
number of unreal kills
vision_wards_bought_in_game
number of vision wards bough in game
wards_killed
number of wards killed
wards_placed
number of wards placed
team_stats/game_x
team stats & details per particular map
baron_kills_a
number of baron kills of team_a
baron_kills_b
number of baron kills of team_b
champion_ban_1_a
1st champion banned by team_a
champion_ban_1_b
1st champion banned by team_b
champion_ban_2_a
2nd champion banned by team_a
champion_ban_2_b
2nd champion banned by team_b
champion_ban_3_a
3rd champion banned by team_a
champion_ban_3_b
3rd champion banned by team_b
champion_ban_4_a
4th champion banned by team_a
champion_ban_4_b
4th champion banned by team_b
champion_ban_5_a
5th champion banned by team_a
champion_ban_5_b
5th champion banned by team_b
dominion_victory_score_a
dominion victory score of team_a
dominion_victory_score_b
dominion victory score of team_b
dragon_kills_a
number of baron kills of team_a
dragon_kills_b
number of baron kills of team_b
duration
duration of the particular map (in seconds)
first_baron_a
if team_a killed first baron then value = true
first_baron_b
if team_b killed first baron then value = true
first_blood_a
if team_a drawn first blood then value = true
first_blood_b
if team_b drawn first blood then value = true
first_dragon_a
if team_a killed first dragon then value = true
first_dragon_b
if team_b killed first dragon then value = true
first_inhibitor_a
if team_a destroyed first inhibitor then value = true
first_inhibitor_b
if team_b destroyed first inhibitor then value = true
first_rift_herald_a
if team_a killed first rift herald then value = true
first_rift_herald_b
if team_b killed first rift herald then value = true
first_tower_a
if team_a destroyed first tower then value = true
first_tower_b
if team_b destroyed first tower then value = true
game_mode
game mode of the particular map
game_type
game type of the particular map
game_version
game version of the particular map
inhibitor_kills_a
number of inhibitor kills of team_a
inhibitor_kills_b
number of inhibitor kills of team_b
map
name of the map
rift_herald_kills_a
number of rift herald kills of team_a
rift_herald_kills_b
number of rift herald kills of team_b
tower_kills_a
number of tower kills of team_a
tower_kills_b
number of tower kills of team_b
vilemaw_kills_a
number of vilemaw kills of team_a
vilemaw_kills_b
number of vilemaw kills of team_b
winner_team_id
unique identifier for the winning team for the particular map
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/lol/get_matches?type={type}&id={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}/lol/get_matches?type={type}&id={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}/lol/get_matches?type={type}&id={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}/lol/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success