No Subscription to this function
GET /tennis/get_draw
Returns all participants of the tournament with draw and seeding positions
Request URL
https://dsg-api.com/clients/{client_name}/tennis/get_draw?id={season_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
player id to return
lang
string
two-character language code, defaults to 'en'
Nodes
contestant
details about the contestant
common_name
common name of the contestant
contestant_id
unique identifier for the contestant
contestant_nationality_area_id
unique identifier for an area
contestant_nationality_area_name
area name of peoples nationality
contestant_nationality_code
three-letter acronym of the nationality
currency
currency used by the tournament for the prize money
draw_position
darw position of the contestant
first_name
first name of the contestant
last_name
last name of the contestant
match_name
match name of the contestant (aka short name)
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
contestant_team
tournament related details for the contestant team
contestant_team_id
unique identifier for the contestant team/double
currency
currency used by the tournament for the prize money
draw_position
darw position of the contestant team
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
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
sport
sport of the API
version
version of the API
method
details about the API function
method_id
unique ID of method.
name
name of method.
tour
details about a 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"
tournament
details about a specific tournament
gender
defines if male or female playing the tournament, additionally mix is possible
season_id
unique identifier of an particular edition of the tournament
season_name
name of the tournament for this particular year (including sponsor names etc)
season_title
title of the season including gender and type (single,double,mix)
single_double
defines if this is Singles, Doubles or Mix tournament
surface
surface the tournament will be played on (Hard, Clay, Grass)
tournament_id
unique identifier for a tournament
tournament_name
general name of the tournament (without sponsor names etc)
type
type of tournament at the particular tour
winner
unique identifier of the contestant who won the tournament
winner_name
name of the contestant who won the tournament
tour_season
details about a tour season
title
title of the particular tour season
tour_season_id
unique identifier of a tour season
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}/tennis/get_draw?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_draw?id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/tennis/get_draw?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"tennis","lang":"en","method":{"method_id":"124","name":"get_draw"},"tour":{"tour_id":"1","name":"ATP World Tour","gender":"male","tour_season":{"tour_season_id":"19","title":"2019","tournament":{"tournament_id":"1231","tournament_name":"Montreal \/ Toronto Masters","season_id":"19946","season_title":"2019 Mens Singles","season_name":"Rogers Cup (M)","surface":"Hard","gender":"male","type":"ATP World Tour Masters 1000","single_double":"Singles","winner":"","winner_name":"","contestant":[{"contestant_id":"449826","first_name":"Rafael","last_name":"Nadal","common_name":"Rafael Nadal","nationality":"176","seeding":"1","draw_position":"1","prize_money":"","currency":"USD","points":""},{"contestant_id":"449827","first_name":"Alex","last_name":"De Minaur","common_name":"Alex De Minaur","nationality":"19","seeding":"","draw_position":"3","prize_money":"","currency":"USD","points":""},{"contestant_id":"450118","first_name":"Daniel","last_name":"Evans","common_name":"Daniel Evans","nationality":"250","seeding":"Q","draw_position":"4","prize_money":"","currency":"USD","points":""},{"contestant_id":"449998","first_name":"Radu","last_name":"Albot","common_name":"Radu Albot","nationality":"130","seeding":"","draw_position":"5","prize_money":"","currency":"USD","points":""},{"contestant_id":"449832","first_name":"Gilles","last_name":"Simon","common_name":"Gilles Simon","nationality":"76","seeding":"","draw_position":"6","prize_money":"","currency":"USD","points":""},{"contestant_id":"450148","first_name":"Guido","last_name":"Pella","common_name":"Guido Pella","nationality":"16","seeding":"","draw_position":"7","prize_money":"","currency":"USD","points":""},{"contestant_id":"449916","first_name":"David","last_name":"Goffin","common_name":"David Goffin","nationality":"27","seeding":"15","draw_position":"8","prize_money":"","currency":"USD","points":""},{"contestant_id":"449986","first_name":"Borna","last_name":"Coric","common_name":"Borna Coric","nationality":"56","seeding":"11","draw_position":"9","prize_money":"","currency":"USD","points":""},{"contestant_id":"450063","first_name":"Peter","last_name":"Gojowczyk","common_name":"Peter Gojowczyk","nationality":"80","seeding":"SE","draw_position":"10","prize_money":"","currency":"USD","points":""},{"contestant_id":"449966","first_name":"Mikhail","last_name":"Kukushkin","common_name":"Mikhail Kukushkin","nationality":"104","seeding":"","draw_position":"11","prize_money":"","currency":"USD","points":""},{"contestant_id":"449877","first_name":"Adrian","last_name":"Mannarino","common_name":"Adrian Mannarino","nationality":"76","seeding":"","draw_position":"12","prize_money":"","currency":"USD","points":""},{"contestant_id":"450387","first_name":"Tommy","last_name":"Paul","common_name":"Tommy Paul","nationality":"203","seeding":"Q","draw_position":"13","prize_money":"","currency":"USD","points":""},{"contestant_id":"186899","first_name":"Brayden","last_name":"Schnur","common_name":"Brayden Schnur","nationality":"43","seeding":"WC","draw_position":"14","prize_money":"","currency":"USD","points":""},{"contestant_id":"450116","first_name":"Fabio","last_name":"Fognini","common_name":"Fabio Fognini","nationality":"100","seeding":"7","draw_position":"16","prize_money":"","currency":"USD","points":""},{"contestant_id":"449894","first_name":"Stefanos","last_name":"Tsitsipas","common_name":"Stefanos Tsitsipas","nationality":"82","seeding":"4","draw_position":"17","prize_money":"","currency":"USD","points":""},{"contestant_id":"450467","first_name":"Hubert","last_name":"Hurkacz","common_name":"Hubert Hurkacz","nationality":"155","seeding":"Alt","draw_position":"19","prize_money":"","currency":"USD","points":""},{"contestant_id":"450149","first_name":"Taylor","last_name":"Fritz","common_name":"Taylor Fritz","nationality":"203","seeding":"","draw_position":"20","prize_money":"","currency":"USD","points":""},{"contestant_id":"450049","first_name":"Ilya","last_name":"Ivashka","common_name":"Ilya Ivashka","nationality":"26","seeding":"Q","draw_position":"21","prize_money":"","currency":"USD","points":""},{"contestant_id":"450011","first_name":"Soon Woo","last_name":"Kwon","common_name":"Soon Woo Kwon","nationality":"107","seeding":"Q","draw_position":"22","prize_money":"","currency":"USD","points":""},{"contestant_id":"450038","first_name":"Peter","last_name":"Polansky","common_name":"Peter Polansky","nationality":"43","seeding":"WC","draw_position":"23","prize_money":"","currency":"USD","points":""},{"contestant_id":"450153","first_name":"Gael","last_name":"Monfils","common_name":"Gael Monfils","nationality":"76","seeding":"16","draw_position":"24","prize_money":"","currency":"USD","points":""},{"contestant_id":"449995","first_name":"Roberto","last_name":"Bautista Agut","common_name":"Roberto Bautista Agut","nationality":"176","seeding":"10","draw_position":"25","prize_money":"","currency":"USD","points":""},{"contestant_id":"449843","first_name":"Bernard","last_name":"Tomic","common_name":"Bernard Tomic","nationality":"19","seeding":"Q","draw_position":"26","prize_money":"","currency":"USD","points":""},{"contestant_id":"450181","first_name":"Marco","last_name":"Cecchinato","common_name":"Marco Cecchinato","nationality":"100","seeding":"","draw_position":"27","prize_money":"","currency":"USD","points":""},{"contestant_id":"449830","first_name":"Diego","last_name":"Schwartzman","common_name":"Diego Schwartzman","nationality":"16","seeding":"","draw_position":"28","prize_money":"","currency":"USD","points":""},{"contestant_id":"449975","first_name":"Benoit","last_name":"Paire","common_name":"Benoit Paire","nationality":"76","seeding":"","draw_position":"29","prize_money":"","currency":"USD","points":""},{"contestant_id":"450152","first_name":"Richard","last_name":"Gasquet","common_name":"Richard Gasquet","nationality":"76","seeding":"","draw_position":"30","prize_money":"","currency":"USD","points":""},{"contestant_id":"449824","first_name":"Kei","last_name":"Nishikori","common_name":"Kei Nishikori","nationality":"102","seeding":"5","draw_position":"32","prize_money":"","currency":"USD","points":""},{"contestant_id":"449908","first_name":"Karen","last_name":"Khachanov","common_name":"Karen Khachanov","nationality":"160","seeding":"6","draw_position":"33","prize_money":"","currency":"USD","points":""},{"contestant_id":"449858","first_name":"Stanislas","last_name":"Wawrinka","common_name":"Stan Wawrinka","nationality":"185","seeding":"","draw_position":"35","prize_money":"","currency":"USD","points":""},{"contestant_id":"449823","first_name":"Grigor","last_name":"Dimitrov","common_name":"Grigor Dimitrov","nationality":"38","seeding":"","draw_position":"36","prize_money":"","currency":"USD","points":""},{"contestant_id":"450365","first_name":"Félix","last_name":"Auger-Aliassime","common_name":"Félix Auger-Aliassime","nationality":"43","seeding":"","draw_position":"37","prize_money":"","currency":"USD","points":""},{"contestant_id":"449911","first_name":"Vasek","last_name":"Pospisil","common_name":"Vasek Pospisil","nationality":"43","seeding":"WC","draw_position":"38","prize_money":"","currency":"USD","points":""},{"contestant_id":"449831","first_name":"Lucas","last_name":"Pouille","common_name":"Lucas Pouille","nationality":"76","seeding":"","draw_position":"39","prize_money":"","currency":"USD","points":""},{"contestant_id":"449848","first_name":"Milos","last_name":"Raonic","common_name":"Milos Raonic","nationality":"43","seeding":"","draw_position":"40","prize_money":"","currency":"USD","points":""},{"contestant_id":"449965","first_name":"Kevin","last_name":"Anderson","common_name":"Kevin Anderson","nationality":"175","seeding":"9","draw_position":"40","prize_money":"","currency":"USD","points":""},{"contestant_id":"450115","first_name":"Nikoloz","last_name":"Basilashvili","common_name":"Nikoloz Basilashvili","nationality":"79","seeding":"","draw_position":"41","prize_money":"","currency":"USD","points":""},{"contestant_id":"449961","first_name":"Dusan","last_name":"Lajovic","common_name":"Dusan Lajovic","nationality":"224","seeding":"","draw_position":"42","prize_money":"","currency":"USD","points":""},{"contestant_id":"449921","first_name":"Jan-Lennard","last_name":"Struff","common_name":"Jan-Lennard Struff","nationality":"80","seeding":"","draw_position":"43","prize_money":"","currency":"USD","points":""},{"contestant_id":"449902","first_name":"Jo-Wilfried","last_name":"Tsonga","common_name":"Jo-Wilfried Tsonga","nationality":"76","seeding":"WC","draw_position":"44","prize_money":"","currency":"USD","points":""},{"contestant_id":"450045","first_name":"Marton","last_name":"Fucsovics","common_name":"Marton Fucsovics","nationality":"92","seeding":"","draw_position":"45","prize_money":"","currency":"USD","points":""},{"contestant_id":"449872","first_name":"Cameron","last_name":"Norrie","common_name":"Cameron Norrie","nationality":"250","seeding":"","draw_position":"46","prize_money":"","currency":"USD","points":""},{"contestant_id":"450141","first_name":"Alexander","last_name":"Zverev","common_name":"Alexander Zverev","nationality":"80","seeding":"3","draw_position":"48","prize_money":"","currency":"USD","points":""},{"contestant_id":"449990","first_name":"Daniil","last_name":"Medvedev","common_name":"Daniil Medvedev","nationality":"160","seeding":"8","draw_position":"49","prize_money":"","currency":"USD","points":""},{"contestant_id":"450138","first_name":"Nick","last_name":"Kyrgios","common_name":"Nick Kyrgios","nationality":"19","seeding":"","draw_position":"51","prize_money":"","currency":"USD","points":""},{"contestant_id":"449840","first_name":"Kyle","last_name":"Edmund","common_name":"Kyle Edmund","nationality":"250","seeding":"","draw_position":"52","prize_money":"","currency":"USD","points":""},{"contestant_id":"450042","first_name":"Laslo","last_name":"Djere","common_name":"Laslo Djere","nationality":"224","seeding":"","draw_position":"53","prize_money":"","currency":"USD","points":""},{"contestant_id":"450035","first_name":"Christian","last_name":"Garin","common_name":"Christian Garin","nationality":"48","seeding":"","draw_position":"54","prize_money":"","currency":"USD","points":""},{"contestant_id":"449852","first_name":"Jordan","last_name":"Thompson","common_name":"Jordan Thompson","nationality":"19","seeding":"","draw_position":"55","prize_money":"","currency":"USD","points":""},{"contestant_id":"449970","first_name":"John","last_name":"Isner","common_name":"John Isner","nationality":"203","seeding":"12","draw_position":"56","prize_money":"","currency":"USD","points":""},{"contestant_id":"449997","first_name":"Marin","last_name":"Cilic","common_name":"Marin Cilic","nationality":"56","seeding":"14","draw_position":"57","prize_money":"","currency":"USD","points":""},{"contestant_id":"450388","first_name":"Bradley","last_name":"Klahn","common_name":"Bradley Klahn","nationality":"203","seeding":"Q","draw_position":"58","prize_money":"","currency":"USD","points":""},{"contestant_id":"450230","first_name":"Matteo","last_name":"Berrettini","common_name":"Matteo Berrettini","nationality":"100","seeding":"","draw_position":"59","prize_money":"","currency":"USD","points":""},{"contestant_id":"450238","first_name":"John","last_name":"Millman","common_name":"John Millman","nationality":"19","seeding":"LL","draw_position":"59","prize_money":"","currency":"USD","points":""},{"contestant_id":"450127","first_name":"Feliciano","last_name":"Lopez","common_name":"Feliciano Lopez","nationality":"176","seeding":"Q","draw_position":"60","prize_money":"","currency":"USD","points":""},{"contestant_id":"449838","first_name":"Pierre-Hugues","last_name":"Herbert","common_name":"Pierre-Hugues Herbert","nationality":"76","seeding":"","draw_position":"61","prize_money":"","currency":"USD","points":""},{"contestant_id":"450182","first_name":"Denis","last_name":"Shapovalov","common_name":"Denis Shapovalov","nationality":"43","seeding":"","draw_position":"62","prize_money":"","currency":"USD","points":""},{"contestant_id":"449847","first_name":"Dominic","last_name":"Thiem","common_name":"Dominic Thiem","nationality":"20","seeding":"2","draw_position":"64","prize_money":"","currency":"USD","points":""}]}}}}}