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
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
nationality
nationality of the contestant
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
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
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
Rate limit exceeded
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":""}]}}}}}