DataSportsGroup API - Golf

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

v3 GET /golf/get_results

Returns the results of the specific round/discipline

Request URL

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

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)

int Required

season or round id to return

lang

string

two-character language code, defaults to 'en'

plays

string

value "yes" displays hole-by-hole content Seperate subscription is needed

stats

string

value "yes" displays player stats content Seperate subscription is needed

type

string Required

type is either "season" or "round"

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)

contestant❯

golf results for the contestant

common_name

common name of the person

current_round

current round

current_round_id

round_id of the current round

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

par_round_1

par value for round 1

par_round_2

par value for round 2

par_round_3

par value for round 3

par_round_4

par value for round 4

people_id

unique identifier for person

position

position value

short_name

shortened name of the person

status

status for this round, mainly if qualified or not (qualied = Q for example)

strokes_round_1

number of strokes in round 1

strokes_round_2

number of strokes in round 2

strokes_round_3

number of strokes in round 3

strokes_round_4

number of strokes in round 4

tee_time_today

todays tee time (starting time)

thru

number of holes they player finished already

today_par

par value for today

total_par

total par

total_strokes

total number of strokes

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)

method❯

details about the API function

method_id

unique ID of method

name

name of method

round❯

details about the round

average_putts

average putts made

birdies

number of birdies

bogeys

number of bogeys

doubles

number of doubles

driving_distance_avg

average driving distance made

eagles

number of eagles

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'

fairway_hits

number of fairway hits

fairway_opportunities

number of fairway opportunities

feet_of_putts_made

feet of putts made

green_in_regulation

number of green in regulation (GIR)

green_in_regulation_opportunities

number of green in regulation (GIR) opportunities

last_updated

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

longest_drive

Longest drive

name

name of round

pars

number of pars

penalties

number of penalties

putts_per_round

putts per round

round_id

unique identifier of round

sand_saves

number of sand saves

sand_saves_opportunities

number of sand saves opportunities

scrambling

number of scramblings

scrambling_opportunities

number of scrambling opportunities

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'

strokes_gained_approach_the_green

average strokes gained approach the green

strokes_gained_around_the_green

average strokes gained around the green

strokes_gained_off_the_tee

average strokes gained off the tee

strokes_gained_putting

average strokes gained putting

strokes_gained_tee_to_green

average strokes gained tee to green

strokes_gained_total

average strokes gained total

total_putts

number of total putts

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

stats❯

details about player stats for the tournament

average_putts

average putts made

birdies

number of birdies

bogeys

number of bogeys

doubles

number of doubles

driving_distance_avg

average driving distance made

eagles

number of eagles

fairway_hits

number of fairway hits

fairway_opportunities

number of fairway opportunities

feet_of_putts_made

feet of putts made

green_in_regulation

number of green in regulation (GIR)

green_in_regulation_opportunities

number of green in regulation (GIR) opportunities

longest_drive

Longest drive

pars

number of pars

penalties

number of penalties

putts_per_round

putts per round

sand_saves

number of sand saves

sand_saves_opportunities

number of sand saves opportunities

scrambling

number of scramblings

scrambling_opportunities

number of scrambling opportunities

strokes_gained_approach_the_green

average strokes gained approach the green

strokes_gained_around_the_green

average strokes gained around the green

strokes_gained_off_the_tee

average strokes gained off the tee

strokes_gained_putting

average strokes gained putting

strokes_gained_tee_to_green

average strokes gained tee to green

strokes_gained_total

average strokes gained total

total_putts

number of total putts

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_image

full path URL of venue or circuit image

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

Response Example

200 Success