DataSportsGroup API - Soccer - get_season

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

v3 GET /soccer/get_season_venue

Returns list of all venues for a particular season

Request URL

https://dsg-api.com/clients/{client_name}/soccer/get_season_venue?id={season_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)

int Required

unique season_id

lang

string

two-character language code, defaults to 'en'

Nodes

venue❯

details about the venue

address

name of street and street number

address_zip

ZIP code

area_id

unique identifier for an area

area_name

name of the area

capacity

maximum capacity of the venue

city_id

unique identifier for cities

city_name

name of the city

geo_latitude

latitude coordinates of venue

geo_longtitude

longitude coordinates of venue

last_updated

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

name

current name of the venue

nicknames

nicknames of the venue. If more as 1 then seperated with a ","

opened

year venue was opened. Format 'yyyy'

status

the current status of the venue ('open' or 'demolished')

surface

type of surface (grass, artificial turf, ice, sand, water, parquet, asphalt, snow, canvas, hard)

venue_id

unique identifier 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}/soccer/get_season_venue?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}/soccer/get_season_venue?id={season_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}/soccer/get_season_venue?id={season_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}/soccer/get_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success