American Football
Australian Football
Baseball
Basketball
Cricket
Golf
Handball
Ice Hockey
Motorsports
Rugby
Soccer
Tennis
Volleyball
Call of Duty
Counter Strike GO
Dota 2
FIFA
League of Legends
NBA 2K
Overwatch
PUBG
Rainbow Six
Rocket League
StarCraft II
Archery
Artistic Swimming
Athletics
Bobsledding
Boxing
Breaking
Canoeing
Curling
Diving
Equestrian
Fencing
Goalball
Gymnastics
Judo
Karate
Luge
Modern Pentathlon
Rowing
Sailing
Shooting
Skateboarding
Sport Climbing
Surfing
Swimming
Taekwondo
Triathlon
Weightlifting
Wrestling
Alpine Skiing
Badminton
Bandy
Biathlon
Boccia
Bowling
Bowls
Cross-country skiing
Cycling
Darts
Field Hockey
Figure Skating
Floorball
Freestyle Skiing
Kabaddi
Lacrosse
Mixed Martial Arts
Multi-Sport
Netball
Nordic Combined
Powerlifting
Short track speed skating
Ski Jumping
Snooker
Snowboarding
Speed skating
Squash
Sumō
Table Tennis
Water PoloSubscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /baseball/get_season_venue
Returns list of all venues for a particular season
Request URL
https://dsg-api.com/clients/{client_name}/baseball/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)
id
int Required
unique season_id
lang
string
two-character language code, defaults to 'en'
Nodes
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
method❯
details about the API function
method_id
unique ID of method
name
name of method
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}/baseball/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}/baseball/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}/baseball/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}/baseball/get_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example200 Success{"datasportsgroup":{"version":"2.0","sport":"baseball","lang":"en","method":{"method_id":"340","name":"get_season_venue"},"venue":[{"venue_id":"1946","name":"Yankee Stadium","city":"New York, NY","area":"United States","area_id":"203","adress":"One East 161st Street, The Bronx","adress_zip":"","oepened":"2009","status":"open","nicknames":"","geo_latitude":"40.829167","geo_longtitude":"-73.926389","capacity":"54251","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"3266","name":"Marlins Park","city":"Miami, FL","area":"United States","area_id":"203","adress":"501 Marlins Way","adress_zip":"33125","oepened":"2012","status":"open","nicknames":"","geo_latitude":"25.778056","geo_longtitude":"-80.219722","capacity":"37442","surface":"grass","last_updated":"2016-07-01 17:23:01"},{"venue_id":"4492","name":"Wrigley Field","city":"Chicago, IL","area":"United States","area_id":"203","adress":"1060 West Addison Street","adress_zip":"60613","oepened":"1914","status":"open","nicknames":"Weeghman Park, Cubs Park","geo_latitude":"41.94825187994973","geo_longtitude":"-87.65556693077087","capacity":"42374","surface":"grass","last_updated":"2016-05-17 12:04:39"},{"venue_id":"4495","name":"Chase Field","city":"Phoenix, AZ","area":"United States","area_id":"203","adress":"401 East Jefferson Street","adress_zip":"85004","oepened":"1998","status":"open","nicknames":"Bank One Ballpark","geo_latitude":"33.445519892280565","geo_longtitude":"-112.06671595573425","capacity":"48686","surface":"grass","last_updated":"2016-05-20 10:32:49"},{"venue_id":"6719","name":"Angel Stadium of Anaheim","city":"Anaheim, CA","area":"United States","area_id":"203","adress":"2000 Gene Autry Way","adress_zip":"92806","oepened":"1964","status":"open","nicknames":"Edison International Field of Anaheim, The Big A","geo_latitude":"33.80031080022559","geo_longtitude":"-117.88272678852081","capacity":"45957","surface":"grass","last_updated":"2016-11-20 20:07:49"},{"venue_id":"6720","name":"Oakland–Alameda County Coliseum","city":"Oakland, CA","area":"United States","area_id":"203","adress":"7000 Coliseum Way","adress_zip":"94621","oepened":"1966","status":"open","nicknames":"Oakland Coliseum, The Coliseum, Network Associates Coliseum, McAfee Coliseum","geo_latitude":"37.751549880119384","geo_longtitude":"-122.20073461532593","capacity":"63132","surface":"grass","last_updated":"2018-04-05 14:30:12"},{"venue_id":"7937","name":"Tropicana Field","city":"St. Petersburg, FL","area":"United States","area_id":"203","adress":"One Tropicana Drive","adress_zip":"33705","oepened":"1990","status":"open","nicknames":"Florida Suncoast Dome, Thunderdome, The Trop","geo_latitude":"40.829478952560095","geo_longtitude":"-73.926642537117","capacity":"42735","surface":"artificial turf","last_updated":"2018-04-20 13:46:00"},{"venue_id":"9412","name":"Kauffman Stadium","city":"Kansas City, MO","area":"United States","area_id":"203","adress":"One Royal Way","adress_zip":"64129","oepened":"1973","status":"open","nicknames":"Royals Stadium","geo_latitude":"39.05140181622275","geo_longtitude":"-94.48062479496002","capacity":"40230","surface":"grass","last_updated":"2017-10-03 06:10:56"},{"venue_id":"9413","name":"Busch Stadium","city":"St. Louis, MO","area":"United States","area_id":"203","adress":"700 Clark Avenue","adress_zip":"63102","oepened":"2006","status":"open","nicknames":"","geo_latitude":"38.6225160802949","geo_longtitude":"-90.1929098367691","capacity":"46861","surface":"grass","last_updated":"2017-10-03 06:12:05"},{"venue_id":"9414","name":"Nationals Park","city":"Washington, D.C.","area":"United States","area_id":"203","adress":"1500 South Capitol Street Southeast","adress_zip":"20003","oepened":"2008","status":"open","nicknames":"","geo_latitude":"38.872976324146954","geo_longtitude":"-77.00755655765533","capacity":"41487","surface":"grass","last_updated":"2017-10-03 06:13:02"},{"venue_id":"9415","name":"Citi Field","city":"Flushing, NY","area":"United States","area_id":"203","adress":"126th Street & Roosevelt Avenue","adress_zip":"11368","oepened":"2009","status":"open","nicknames":"","geo_latitude":"40.75697342724877","geo_longtitude":"-73.84579539299011","capacity":"45000","surface":"grass","last_updated":"2017-10-03 06:14:30"},{"venue_id":"9416","name":"Fenway Park","city":"Boston, MA","area":"United States","area_id":"203","adress":"4 Yawkey Way","adress_zip":"02215","oepened":"1912","status":"open","nicknames":"","geo_latitude":"42.346555640154364","geo_longtitude":"-71.09743773937225","capacity":"37493","surface":"grass","last_updated":"2017-10-03 06:15:22"},{"venue_id":"9417","name":"Miller Park","city":"Milwaukee, WI","area":"United States","area_id":"203","adress":"One Brewers Way","adress_zip":"53214","oepened":"2001","status":"open","nicknames":"","geo_latitude":"43.02781193891276","geo_longtitude":"-87.97124683856964","capacity":"46017","surface":"grass","last_updated":"2017-10-03 06:16:24"},{"venue_id":"9418","name":"Oriole Park at Camden Yards","city":"Baltimore, MD","area":"United States","area_id":"203","adress":"333 West Camden Street","adress_zip":"21201","oepened":"1992","status":"open","nicknames":"Camden Yards","geo_latitude":"39.28384818449639","geo_longtitude":"-76.62182003259659","capacity":"46773","surface":"grass","last_updated":"2018-04-05 11:33:31"},{"venue_id":"9419","name":"Target Field","city":"Minneapolis, MN","area":"United States","area_id":"203","adress":"1 Twins Way","adress_zip":"55403","oepened":"2010","status":"open","nicknames":"","geo_latitude":"44.97944686771267","geo_longtitude":"-93.27642560005188","capacity":"39504","surface":"grass","last_updated":"2017-10-03 06:19:14"},{"venue_id":"9420","name":"Great American Ball Park","city":"Cincinnati, OH","area":"United States","area_id":"203","adress":"100 Joe Nuxhall Way","adress_zip":"45202","oepened":"2003","status":"open","nicknames":"","geo_latitude":"39.09696627861277","geo_longtitude":"-84.50655162334442","capacity":"42319","surface":"grass","last_updated":"2017-10-03 06:20:03"},{"venue_id":"9421","name":"Dodger Stadium","city":"Dodgertown, CA","area":"United States","area_id":"203","adress":"1000 Elysian Park Avenue","adress_zip":"90090","oepened":"1962","status":"open","nicknames":"","geo_latitude":"34.073759495345456","geo_longtitude":"-118.24017405509949","capacity":"56000","surface":"grass","last_updated":"2017-10-03 06:22:26"},{"venue_id":"9422","name":"Guaranteed Rate Field","city":"Chicago, IL","area":"United States","area_id":"203","adress":"333 West 35th Street","adress_zip":"60616","oepened":"1991","status":"open","nicknames":"Comiskey Park, U.S. Cellular Field","geo_latitude":"41.82974523528118","geo_longtitude":"-87.63396441936493","capacity":"41432","surface":"grass","last_updated":"2017-10-03 06:25:10"},{"venue_id":"9423","name":"Minute Maid Park","city":"Houston, TX","area":"United States","area_id":"203","adress":"501 Crawford Street","adress_zip":"77002","oepened":"2000","status":"open","nicknames":"The Ballpark at Union Station, Enron Field, Astros Field, ","geo_latitude":"29.757189480423865","geo_longtitude":"-95.35526633262634","capacity":"40963","surface":"grass","last_updated":"2017-10-03 06:26:25"},{"venue_id":"9424","name":"Globe Life Park in Arlington","city":"Arlington, TX","area":"United States","area_id":"203","adress":"1000 Ballpark Way","adress_zip":"76011","oepened":"1994","status":"open","nicknames":"The Ballpark in Arlington, Ameriquest Field in Arlington","geo_latitude":"32.75125200667302","geo_longtitude":"-97.08245873451233","capacity":"48194","surface":"grass","last_updated":"2017-10-03 06:27:17"},{"venue_id":"9425","name":"PNC Park ","city":"Pittsburgh, PA","area":"United States","area_id":"203","adress":"115 Federal Street","adress_zip":"15212","oepened":"2001","status":"open","nicknames":"","geo_latitude":"40.44684908289761","geo_longtitude":"-80.00567078590393","capacity":"38362","surface":"grass","last_updated":"2017-10-03 06:30:17"},{"venue_id":"9426","name":"Coors Field","city":"Denver, CO","area":"United States","area_id":"203","adress":"2001 Blake Street","adress_zip":"80205","oepened":"1995","status":"open","nicknames":"","geo_latitude":"39.75637474580115","geo_longtitude":"-104.99425113201141","capacity":"50398","surface":"grass","last_updated":"2017-10-03 06:30:58"},{"venue_id":"9427","name":"Citizens Bank Park","city":"Philadelphia, PA","area":"United States","area_id":"203","adress":"One Citizens Bank Way","adress_zip":"19148","oepened":"2004","status":"open","nicknames":"","geo_latitude":"39.906176831603226","geo_longtitude":"-75.16622543334961","capacity":"43651","surface":"grass","last_updated":"2017-10-03 06:31:28"},{"venue_id":"9428","name":"Petco Park","city":"San Diego, CA","area":"United States","area_id":"203","adress":"19 Tony Gwynn Drive","adress_zip":"92101","oepened":"2004","status":"open","nicknames":"","geo_latitude":"32.70743564911153","geo_longtitude":"-117.15723484754562","capacity":"42691","surface":"grass","last_updated":"2017-10-03 06:32:01"},{"venue_id":"9429","name":"Comerica Park","city":"Detroit, MI","area":"United States","area_id":"203","adress":"2100 Woodward Avenue","adress_zip":"41255","oepened":"2000","status":"open","nicknames":"","geo_latitude":"42.33902215335092","geo_longtitude":"-83.04870665073395","capacity":"45010","surface":"grass","last_updated":"2017-10-03 06:32:50"},{"venue_id":"9430","name":"SunTrust Park","city":"Cumberland, GA","area":"United States","area_id":"203","adress":"755 Battery Avenue","adress_zip":"30339","oepened":"2017","status":"open","nicknames":"","geo_latitude":"33.8907047","geo_longtitude":"-84.4698728","capacity":"41500","surface":"grass","last_updated":"2017-10-03 06:38:09"},{"venue_id":"9431","name":"AT&T Park","city":"San Francisco, CA","area":"United States","area_id":"203","adress":"24 Willie Mays Plaza","adress_zip":"94107","oepened":"2000","status":"open","nicknames":"Pacific Bell Park, SBC Park","geo_latitude":"37.778380987421265","geo_longtitude":"-122.38912224769592","capacity":"41915","surface":"grass","last_updated":"2017-10-03 06:39:54"},{"venue_id":"9432","name":"Progressive Field","city":"Cleveland, OH","area":"United States","area_id":"203","adress":"2401 Ontario Street","adress_zip":"44115","oepened":"1994","status":"open","nicknames":"Gateway Stadium, Jacobs Field","geo_latitude":"41.49594404449149","geo_longtitude":"-81.68526470661163","capacity":"45274","surface":"grass","last_updated":"2017-10-03 06:41:04"},{"venue_id":"9433","name":"T-Mobile Park","city":"Seattle, WA","area":"United States","area_id":"203","adress":"1516 First Avenue South","adress_zip":"98134","oepened":"1999","status":"open","nicknames":"","geo_latitude":"47.59143330484047","geo_longtitude":"-122.33250081539154","capacity":"47878","surface":"grass","last_updated":"2019-01-09 13:09:17"},{"venue_id":"9434","name":"Rogers Centre","city":"Toronto, ON","area":"Canada","area_id":"43","adress":"One Blue Jays Way","adress_zip":"M5V 1J3","oepened":"1989","status":"open","nicknames":"SkyDome","geo_latitude":"43.64165006762105","geo_longtitude":"-79.38889145851135","capacity":"49260","surface":"artificial turf","last_updated":"2017-10-03 06:43:44"},{"venue_id":"11578","name":"Estadio Hiram Bithorn","city":"San Juan","area":"Puerto Rico","area_id":"157","adress":"Av. Franklin Delano Roosevelt","adress_zip":"00920","oepened":"1963","status":"open","nicknames":"Hiram Bithorn Stadium","geo_latitude":"18.416667","geo_longtitude":"-66.073056","capacity":"18264","surface":"grass","last_updated":"2018-04-05 11:05:37"},{"venue_id":"11579","name":"Estadio de Béisbol Monterrey","city":"Monterrey, Nuevo León","area":"Mexico","area_id":"129","adress":"Av. Manuel L. Barragán","adress_zip":"64290","oepened":"1990","status":"open","nicknames":"Estadio Mobil Super","geo_latitude":"25.718517","geo_longtitude":"-100.31575","capacity":"26999","surface":"grass","last_updated":"2018-04-05 11:12:38"}]}}