Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /basketball/get_season_venue
Returns list of all venues for a particular season
Request URL
https://dsg-api.com/clients/{client_name}/basketball/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)
id
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
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/basketball/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}/basketball/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}/basketball/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}/basketball/get_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"basketball","lang":"en","method":{"method_id":"339","name":"get_season_venue"},"venue":[{"venue_id":"4580","name":"Oracle Arena","city":"Oakland, CA","area":"United States","area_id":"203","adress":"7000 Coliseum Way","adress_zip":"94621","oepened":"1966","status":"open","nicknames":"Oakland Arena","geo_latitude":"37.75025621113851","geo_longtitude":"-122.20291793346405","capacity":"19596","surface":"grass","last_updated":"2016-05-25 16:46:41"},{"venue_id":"4581","name":"United Center","city":"Chicago, IL","area":"United States","area_id":"203","adress":"1901 West Madison St","adress_zip":"60612","oepened":"1994","status":"open","nicknames":"","geo_latitude":"41.880776963201754","geo_longtitude":"-87.67416536808014","capacity":"23500","surface":"parquet","last_updated":"2016-05-27 14:53:52"},{"venue_id":"5053","name":"Chesapeake Energy Arena","city":"Oklahoma City, OK","area":"United States","area_id":"203","adress":"100 West Reno Avenue","adress_zip":"73102","oepened":"2002","status":"open","nicknames":"Ford Center, Oklahoma City Arena","geo_latitude":"35.46332212949607","geo_longtitude":"-97.51516878604889","capacity":"18203","surface":"parquet","last_updated":"2016-07-10 00:47:55"},{"venue_id":"5054","name":"Quicken Loans Arena","city":"Cleveland, OH","area":"United States","area_id":"203","adress":"1 Center Court","adress_zip":"44115","oepened":"1994","status":"open","nicknames":"Gund Arena","geo_latitude":"41.496572852678256","geo_longtitude":"-81.68796300888062","capacity":"20562","surface":"parquet","last_updated":"2016-07-10 00:52:27"},{"venue_id":"5055","name":"Scotiabank Arena","city":"Toronto, ON","area":"Canada","area_id":"43","adress":"40 Bay Street","adress_zip":"M5J 2X2","oepened":"1999","status":"open","nicknames":"Air Canada Centre","geo_latitude":"43.64342220659911","geo_longtitude":"-79.37909871339798","capacity":"20910","surface":"parquet","last_updated":"2018-08-16 12:19:52"},{"venue_id":"5056","name":"AmericanAirlines Arena","city":"Miami, FL","area":"United States","area_id":"203","adress":"601 Biscayne Boulevard","adress_zip":"33132","oepened":"1999","status":"open","nicknames":"","geo_latitude":"25.781341303877912","geo_longtitude":"-80.18790543079376","capacity":"20350","surface":"parquet","last_updated":"2017-08-25 04:57:49"},{"venue_id":"5057","name":"State Farm Arena","city":"Atlanta, GA","area":"United States","area_id":"203","adress":"1 Philips Drive Northwest","adress_zip":"30303","oepened":"1999","status":"open","nicknames":"Philips Arena","geo_latitude":"33.75726057939097","geo_longtitude":"-84.39658641815186","capacity":"19521","surface":"parquet","last_updated":"2018-08-31 07:58:11"},{"venue_id":"5058","name":"AT&T Center","city":"San Antonio, TX","area":"United States","area_id":"203","adress":"1 AT&T Center Parkway","adress_zip":"78219","oepened":"2002","status":"open","nicknames":"SBC Center","geo_latitude":"29.42717933830185","geo_longtitude":"-98.43742489814758","capacity":"19615","surface":"parquet","last_updated":"2016-07-10 02:04:10"},{"venue_id":"5059","name":"Moda Center","city":"Portland, OR","area":"United States","area_id":"203","adress":"1 Center Court","adress_zip":"97227","oepened":"1995","status":"open","nicknames":"Rose Garden","geo_latitude":"45.531620415205545","geo_longtitude":"-122.66681671142578","capacity":"20700","surface":"parquet","last_updated":"2016-07-10 02:46:22"},{"venue_id":"5060","name":"Staples Center","city":"Los Angeles, CA","area":"United States","area_id":"203","adress":"1111 South Figueroa Street","adress_zip":"90015","oepened":"1999","status":"open","nicknames":"","geo_latitude":"34.04311644576835","geo_longtitude":"-118.26732873916626","capacity":"20200","surface":"parquet","last_updated":"2016-07-10 03:19:57"},{"venue_id":"5061","name":"American Airlines Center","city":"Dallas, TX","area":"United States","area_id":"203","adress":"2500 Victory Avenue","adress_zip":"75201","oepened":"2001","status":"open","nicknames":"","geo_latitude":"32.79061171335078","geo_longtitude":"-96.81039690971375","capacity":"21146","surface":"parquet","last_updated":"2016-07-10 03:43:20"},{"venue_id":"5062","name":"Toyota Center","city":"Houston, TX","area":"United States","area_id":"203","adress":"1510 Polk Street","adress_zip":"77002","oepened":"2003","status":"open","nicknames":"","geo_latitude":"29.75070898957293","geo_longtitude":"-95.36205232143402","capacity":"18523","surface":"grass","last_updated":"2016-07-10 03:45:45"},{"venue_id":"5063","name":"FedExForum","city":"Memphis, TN","area":"United States","area_id":"203","adress":"191 Beale Street","adress_zip":"38103","oepened":"2004","status":"open","nicknames":"","geo_latitude":"35.138199359556594","geo_longtitude":"-90.05052208900452","capacity":"18119","surface":"parquet","last_updated":"2016-07-10 03:48:01"},{"venue_id":"5064","name":"Bankers Life Fieldhouse","city":"Indianapolis, IN","area":"United States","area_id":"203","adress":"125 South Pennsylvania Street","adress_zip":"46204","oepened":"1999","status":"open","nicknames":"Conseco Fieldhouse","geo_latitude":"39.76395425413882","geo_longtitude":"-86.1554503440857","capacity":"19156","surface":"parquet","last_updated":"2016-07-10 14:54:12"},{"venue_id":"5066","name":"TD Garden","city":"Boston, MA","area":"United States","area_id":"203","adress":"100 Legends Way","adress_zip":"02114","oepened":"1995","status":"open","nicknames":"Shawmut Center, FleetCenter, TD Banknorth Garden","geo_latitude":"42.36632080290764","geo_longtitude":"-71.06236517429352","capacity":"18624","surface":"parquet","last_updated":"2016-07-10 14:57:38"},{"venue_id":"5067","name":"Spectrum Center","city":"Charlotte, NC","area":"United States","area_id":"203","adress":"333 East Trade Street","adress_zip":"28202","oepened":"2005","status":"open","nicknames":"Charlotte Bobcats Arena, Time Warner Cable Arena","geo_latitude":"35.22514827627524","geo_longtitude":"-80.83933353424072","capacity":"19650","surface":"parquet","last_updated":"2017-08-25 04:57:34"},{"venue_id":"5069","name":"Amway Center","city":"Orlando, FL","area":"United States","area_id":"203","adress":"400 West Church Street","adress_zip":"32801","oepened":"2010","status":"open","nicknames":"Orlando Events Center","geo_latitude":"28.53925291047721","geo_longtitude":"-81.38386487960815","capacity":"19400","surface":"parquet","last_updated":"2016-07-12 13:45:40"},{"venue_id":"5070","name":"Barclays Center","city":"New York, NY","area":"United States","area_id":"203","adress":"620 Atlantic Avenue Brooklyn","adress_zip":"11217","oepened":"2012","status":"open","nicknames":"","geo_latitude":"40.71433247","geo_longtitude":"-74.00595701","capacity":"18103","surface":"parquet","last_updated":"2016-07-12 13:53:03"},{"venue_id":"5072","name":"Golden 1 Center","city":"Sacramento, CA","area":"United States","area_id":"203","adress":"One Sports Parkway","adress_zip":"95834","oepened":"1988","status":"open","nicknames":"Sleep Train Arena","geo_latitude":"38.64909940701791","geo_longtitude":"-121.51821970939636","capacity":"17458","surface":"parquet","last_updated":"2017-08-25 04:56:51"},{"venue_id":"5073","name":"Talking Stick Resort Arena","city":"Phoenix, AZ","area":"United States","area_id":"203","adress":"201 East Jefferson","adress_zip":"18055","oepened":"1992","status":"open","nicknames":"US Airways Center, America West Arena","geo_latitude":"33.44583098244037","geo_longtitude":"-112.07132130861282","capacity":"18422","surface":"grass","last_updated":"2016-07-12 14:38:55"},{"venue_id":"5074","name":"Madison Square Garden","city":"New York, NY","area":"United States","area_id":"203","adress":"4 Pennsylvania Plaza","adress_zip":"10121","oepened":"1968","status":"open","nicknames":"","geo_latitude":"40.750504069782096","geo_longtitude":"-73.99352878332138","capacity":"19812","surface":"parquet","last_updated":"2016-07-12 14:50:48"},{"venue_id":"5075","name":"Wells Fargo Center","city":"Philadelphia, PA","area":"United States","area_id":"203","adress":"3601 South Broad Street","adress_zip":"19148","oepened":"1996","status":"open","nicknames":"CoreStates Center, First Union Center, Wachovia Center","geo_latitude":"39.9012592019378","geo_longtitude":"-75.1719868183136","capacity":"21315","surface":"parquet","last_updated":"2016-07-12 14:53:42"},{"venue_id":"5076","name":"Pepsi Center","city":"Denver, CO","area":"United States","area_id":"203","adress":"1000 Chopper Circle","adress_zip":"80204","oepened":"1999","status":"open","nicknames":"","geo_latitude":"39.7486871671947","geo_longtitude":"-105.00759780406952","capacity":"20100","surface":"parquet","last_updated":"2016-07-12 14:57:22"},{"venue_id":"5077","name":"Capital One Arena","city":"Washington, D.C.","area":"United States","area_id":"203","adress":"601 F Street Northwest","adress_zip":"20004","oepened":"1997","status":"open","nicknames":"MCI Center, Verizon Center","geo_latitude":"38.89820988834179","geo_longtitude":"-77.02097833156586","capacity":"23356","surface":"parquet","last_updated":"2017-08-25 04:56:30"},{"venue_id":"5078","name":"Smoothie King Center","city":"New Orleans, LA","area":"United States","area_id":"203","adress":"1501 Girod Street","adress_zip":"70113","oepened":"1999","status":"open","nicknames":"New Orleans Arena","geo_latitude":"29.95102797135777","geo_longtitude":"-90.08134603500366","capacity":"18647","surface":"parquet","last_updated":"2016-07-12 15:01:31"},{"venue_id":"5079","name":"Target Center","city":"Minneapolis, MN","area":"United States","area_id":"203","adress":"600 First Avenue North","adress_zip":"55403","oepened":"1990","status":"open","nicknames":"","geo_latitude":"44.979467737881414","geo_longtitude":"-93.27617883682251","capacity":"20340","surface":"parquet","last_updated":"2016-07-12 15:08:22"},{"venue_id":"5080","name":"Vivint Smart Home Arena","city":"Salt Lake City, UT","area":"United States","area_id":"203","adress":"301 W South Temple","adress_zip":"84101","oepened":"1991","status":"open","nicknames":"Delta Center, Salt Lake Ice Center, EnergySolutions Arena","geo_latitude":"40.768333915819255","geo_longtitude":"-111.90116465091705","capacity":"19911","surface":"parquet","last_updated":"2016-07-12 15:19:01"},{"venue_id":"5081","name":"Arena Ciudad de Mexico","city":"Ciudad de México","area":"Mexico","area_id":"129","adress":"Avenida de las Granjas 800","adress_zip":"","oepened":"2012","status":"open","nicknames":"Mexico City Arena","geo_latitude":"19.4977705","geo_longtitude":"-99.1750296","capacity":"28660","surface":"parquet","last_updated":"2018-08-16 12:24:26"},{"venue_id":"9149","name":"Little Caesars Arena","city":"Detroit, MI","area":"United States","area_id":"203","adress":"Woodward Avenue","adress_zip":"2645","oepened":"2017","status":"open","nicknames":"","geo_latitude":"42.341172","geo_longtitude":"-83.054911","capacity":"21000","surface":"parquet","last_updated":"2018-03-29 16:11:20"},{"venue_id":"12911","name":"Fiserv Forum","city":"Milwaukee, WI","area":"United States","area_id":"203","adress":"1111 Vel R Phillips Avenue","adress_zip":"53203","oepened":"2018","status":"open","nicknames":"Wisconsin Entertainment and Sports Center","geo_latitude":"43.045028","geo_longtitude":"-87.918167","capacity":"17500","surface":"parquet","last_updated":"2018-08-16 12:22:01"}]}}