DataSportsGroup API - Water Polo

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

v3 GET /water_polo/get_team

Returns a list of team details selected from team or season

Request URL

https://dsg-api.com/clients/{client_name}/water_polo/get_team?team={team_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

authkey

string Required

client authentification key

client

string Required

unique client ID

ftype

string

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

lang

string

two-character language code, defaults to 'en'

team

int Required

team id to get details from

Nodes

competition❯

details about the competition

competition_id

unique identifier for a competition

competition_name

name of the competition

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)

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')

match_extra❯

extra informations about the match

attendance

amount of people that attended the particular match

gameweek

contains the gameweek a match belongs to.

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

related_team❯

details about related teams

order

can be used to order the related teams (ascending)

team_id

unique identifier of the team

team_name

current team name

type

type of relation to the main team (reserve, youth, women, related)

round❯

basic identifier details about the round

round_id

unique identifier of round

season❯

identifier details of the season

season_id

unique identifier for season

team❯

basic details about a team

area_id

unique identifier for an area

area_name

name of the area

discipline_id

unique identifier of the discipline

discipline_name

name of the discipline

gender

gender of the team ('male', 'male youth', 'female' or 'female youth')

last_updated

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

short_name

shortened name of the person

status

the current status of the team ('active' or 'defunct')

team_id

unique identifier of the team

team_name

current team name

tla_name

three letter acronym for this team

type

determines the type of team ('national' or 'club' or 'selection')

team_extra❯

extra details about a team

address

name of street and street number

address_city

name of the city

address_zip

ZIP code

club_colors

original colors of club (seperated with / )

founded

year club was founded. Format 'yyyy'

nicknames

nickname of the club. Can contain until 3 different ones seperated with a "/"

official_name

the official name of a team

primary_venue_id

venue_id of the home venue or primary used one for the particular team

primary_venue_name

venue name of the home venue or primary used one for the particular team

team_logo

full path URL of team logo

website

official website address (URL)

team_social_media❯

details about the social media channels of the team

facebook

facebook channel URL

instagram

instagram channel URL

twitter

twitter channel URL

vk channel URL

youtube

youtube channel URL

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}/water_polo/get_team?team={team_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}/water_polo/get_team?team={team_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}/water_polo/get_team?team={team_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}/water_polo/get_team?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success