American Football
Australian Football
Baseball
Basketball
Cricket
Golf
Handball
Ice Hockey
Motorsports
Rugby
Soccer
Tennis
Volleyball
Call of Duty
Counter Strike 2
Dota 2
FIFA
League of Legends
NBA 2K
Overwatch
PUBG
Rainbow Six
Rocket League
StarCraft II
Archery
Artistic Swimming
Athletics
Boxing
Breaking
Canoeing
Diving
Equestrian
Fencing
Gymnastics
Judo
Karate
Modern Pentathlon
Rowing
Sailing
Shooting
Skateboarding
Sport Climbing
Surfing
Swimming
Taekwondo
Triathlon
Weightlifting
Wrestling
Alpine Skiing
Biathlon
Bobsledding
Cross-country skiing
Curling
Figure Skating
Freestyle Skiing
Luge
Nordic Combined
Short track speed skating
Ski Jumping
Snowboarding
Speed skating
Badminton
Bandy
Boccia
Bowling
Bowls
Cycling
Darts
Field Hockey
Floorball
Goalball
Kabaddi
Lacrosse
Mixed Martial Arts
Multi-Sport
Netball
Powerlifting
Snooker
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 /american_football/get_season_venue
Returns list of all venues for a particular season
Request URL
https://dsg-api.com/clients/{client_name}/american_football/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}/american_football/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}/american_football/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}/american_football/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}/american_football/get_season_venue?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example200 Success{"datasportsgroup":{"version":"2.342.3","sport":"american_football","lang":"en","generated_utc":"2025-08-01T15:06:25+00:00","method":{"method_id":"342","name":"get_season_venue"},"venue":[{"venue_id":"9","name":"Levi's Stadium","city_id":"2732","city_name":"Santa Clara, CA","area_name":"United States","area_id":"203","address":"4900 Marie P DeBartolo Boulevard","address_zip":"","opened":"2014","status":"open","nicknames":"The Field of Jeans","geo_latitude":"37.40322778728967","geo_longitude":"-121.96977646895601","capacity":"68500","surface":"grass","last_updated":"2016-07-01 17:23:01","city_state":"","city_state_abbreviation":""},{"venue_id":"10","name":"Northwest Stadium","city_id":"86","city_name":"Landover, MD","area_name":"United States","area_id":"203","address":"1600 FedEx Way","address_zip":"20785","opened":"1997","status":"open","nicknames":"Jack Kent Cooke Stadium, FedExField, Commanders Field","geo_latitude":"38.90768425263718","geo_longitude":"-76.86450898647308","capacity":"91704","surface":"artificial turf","last_updated":"2025-05-15 09:11:17","city_state":"","city_state_abbreviation":""},{"venue_id":"79","name":"Estadio Santiago Bernabéu","city_id":"1205","city_name":"Madrid","area_name":"Spain","area_id":"176","address":"Avenida de Concha Espina 1, Chamartín","address_zip":"28036","opened":"1947","status":"open","nicknames":"El Bernabéu","geo_latitude":"40.453068279113594","geo_longitude":"-3.6883538961410522","capacity":"78297","surface":"grass","last_updated":"2016-07-01 17:23:01","city_state":"","city_state_abbreviation":""},{"venue_id":"98","name":"Gillette Stadium","city_id":"62","city_name":"Foxborough, MA","area_name":"United States","area_id":"203","address":"1388 One Patriot Place","address_zip":"02035","opened":"2002","status":"open","nicknames":"The Razor","geo_latitude":"42.0912961715144","geo_longitude":"-71.26404583454132","capacity":"68756","surface":"artificial turf","last_updated":"2016-07-01 17:23:01","city_state":"","city_state_abbreviation":""},{"venue_id":"105","name":"Lumen Field","city_id":"134","city_name":"Seattle, WA","area_name":"United States","area_id":"203","address":"800 Occidental Avenue South","address_zip":"98134","opened":"2002","status":"open","nicknames":"The Hawk, Hawks Nest, Seahawks Stadium, Qwest Field, CenturyLink Field","geo_latitude":"47.59516315685348","geo_longitude":"-122.33163177967072","capacity":"68740","surface":"artificial turf","last_updated":"2020-11-25 08:26:53","city_state":"","city_state_abbreviation":""},{"venue_id":"195","name":"Neo Química Arena","city_id":"1598","city_name":"São Paulo, SP","area_name":"Brazil","area_id":"35","address":"Avenida Miguel Inácio Curi, 111, Vila Carmosina, Itaquera","address_zip":"08295-005","opened":"2014","status":"open","nicknames":"Arena de São Paulo, New Corinthians Stadium, Fielzão, Arena Corinthians","geo_latitude":"-23.545054923","geo_longitude":"-46.47277951","capacity":"47252","surface":"grass","last_updated":"2020-10-25 17:00:44","city_state":"","city_state_abbreviation":""},{"venue_id":"289","name":"Olympiastadion Berlin","city_id":"263","city_name":"Berlin","area_name":"Germany","area_id":"80","address":"Olympischer Platz 3","address_zip":"14053","opened":"1936","status":"open","nicknames":"","geo_latitude":"52.51462778550934","geo_longitude":"13.23954463005066","capacity":"77116","surface":"grass","last_updated":"2015-08-04 16:21:02","city_state":"Berlin","city_state_abbreviation":""},{"venue_id":"359","name":"Wembley Stadium connected by EE","city_id":"177","city_name":"London","area_name":"England","area_id":"68","address":"Stadium Way, Wembley, Brent","address_zip":"HA9 0WS","opened":"2007","status":"open","nicknames":"","geo_latitude":"51.555855088657374","geo_longitude":"-0.27959346771240234","capacity":"90000","surface":"grass","last_updated":"2024-03-27 19:18:42","city_state":"","city_state_abbreviation":""},{"venue_id":"1962","name":"Soldier Field","city_id":"33","city_name":"Chicago, IL","area_name":"United States","area_id":"203","address":"1410 South Museum Campus Drive","address_zip":"60605","opened":"1924","status":"open","nicknames":"Municipal Grant Park Stadium","geo_latitude":"41.862310033544205","geo_longitude":"-87.61667490005493","capacity":"61500","surface":"grass","last_updated":"2016-07-01 17:23:01","city_state":"","city_state_abbreviation":""},{"venue_id":"1963","name":"State Farm Stadium","city_id":"65","city_name":"Glendale, AZ","area_name":"United States","area_id":"203","address":"1 Cardinals Drive","address_zip":"85305","opened":"2006","status":"open","nicknames":"University of Phoenix Stadium","geo_latitude":"33.527626834495216","geo_longitude":"-112.26252257823944","capacity":"63400","surface":"grass","last_updated":"2019-06-12 14:41:25","city_state":"","city_state_abbreviation":""},{"venue_id":"1964","name":"Bank of America Stadium","city_id":"30","city_name":"Charlotte, NC","area_name":"United States","area_id":"203","address":"800 South Mint Street","address_zip":"28202","opened":"1996","status":"open","nicknames":"","geo_latitude":"35.22582312444026","geo_longitude":"-80.8528733253479","capacity":"73778","surface":"grass","last_updated":"2017-07-10 17:14:06","city_state":"","city_state_abbreviation":""},{"venue_id":"1999","name":"MetLife Stadium","city_id":"54","city_name":"East Rutherford, NJ","area_name":"United States","area_id":"203","address":"1 MetLife Stadium Drive","address_zip":"07073","opened":"2010","status":"open","nicknames":"The Meadowlands, New Meadowlands Stadium","geo_latitude":"40.81355345051812","geo_longitude":"-74.07436788082123","capacity":"82500","surface":"artificial turf","last_updated":"2018-04-18 11:31:59","city_state":"","city_state_abbreviation":""},{"venue_id":"2000","name":"GEHA Field at Arrowhead Stadium","city_id":"80","city_name":"Kansas City, MO","area_name":"United States","area_id":"203","address":"1 Arrowhead Drive","address_zip":"64129","opened":"1972","status":"open","nicknames":"The Sea of Red, Truman Sports Complex","geo_latitude":"39.048931391072365","geo_longitude":"-94.48399364948273","capacity":"79416","surface":"artificial turf","last_updated":"2024-03-19 08:53:58","city_state":"","city_state_abbreviation":""},{"venue_id":"2142","name":"EverBank Stadium","city_id":"77","city_name":"Jacksonville, FL","area_name":"United States","area_id":"203","address":"1 EverBank Field Drive","address_zip":"32202","opened":"1995","status":"open","nicknames":"Jacksonville Municipal Stadium, Alltel Stadium","geo_latitude":"30.323910798388802","geo_longitude":"-81.63732826709747","capacity":"69132","surface":"grass","last_updated":"2024-05-17 16:39:05","city_state":"","city_state_abbreviation":""},{"venue_id":"2310","name":"NRG Stadium","city_id":"72","city_name":"Houston, TX","area_name":"United States","area_id":"203","address":"One Reliant Park","address_zip":"77054","opened":"2002","status":"open","nicknames":"Reliant Stadium","geo_latitude":"29.6848278005025","geo_longitude":"-95.41093826293945","capacity":"71795","surface":"artificial turf","last_updated":"2016-07-01 17:23:01","city_state":"","city_state_abbreviation":""},{"venue_id":"2311","name":"Nissan Stadium","city_id":"110","city_name":"Nashville, TN","area_name":"United States","area_id":"203","address":"1 Titans Way","address_zip":"37213","opened":"1999","status":"open","nicknames":"Adelphia Coliseum, The Coliseum, LP Field","geo_latitude":"36.166488706698225","geo_longitude":"-86.77128553390503","capacity":"69143","surface":"grass","last_updated":"2017-03-07 22:58:08","city_state":"","city_state_abbreviation":""},{"venue_id":"2418","name":"M&T Bank Stadium","city_id":"14","city_name":"Baltimore, MD","area_name":"United States","area_id":"203","address":"1101 Russell Street","address_zip":"21230","opened":"1998","status":"open","nicknames":"Russell Street Coliseum, The Bank, The Purple Palace, The Big Crab Cake, The Nest, Ravens Stadium at Camden Yards, PSINet Stadium, Ravens Stadium","geo_latitude":"39.27798716541208","geo_longitude":"-76.62271857261658","capacity":"71008","surface":"grass","last_updated":"2017-07-09 19:10:01","city_state":"","city_state_abbreviation":""},{"venue_id":"2436","name":"Lincoln Financial Field","city_id":"120","city_name":"Philadelphia, PA","area_name":"United States","area_id":"203","address":"1020 Pattison Avenue","address_zip":"19148","opened":"2003","status":"open","nicknames":"The Linc","geo_latitude":"39.900833","geo_longitude":"-75.1675","capacity":"69176","surface":"grass","last_updated":"2018-04-18 11:24:30","city_state":"","city_state_abbreviation":""},{"venue_id":"2547","name":"AT&T Stadium","city_id":"8","city_name":"Arlington, TX","area_name":"United States","area_id":"203","address":"1 AT&T Way","address_zip":"76001","opened":"2009","status":"open","nicknames":"Cowboys Stadium","geo_latitude":"32.747778","geo_longitude":"-97.092778","capacity":"105121","surface":"artificial turf","last_updated":"2017-07-09 19:12:06","city_state":"","city_state_abbreviation":""},{"venue_id":"5679","name":"Empower Field at Mile High","city_id":"48","city_name":"Denver, CO","area_name":"United States","area_id":"203","address":"1701 Mile High Stadium Circle West","address_zip":"80204","opened":"2001","status":"open","nicknames":"Invesco Field at Mile High, Mile High Stadium","geo_latitude":"39.743935616697655","geo_longitude":"-105.02007275819778","capacity":"76125","surface":"grass","last_updated":"2024-05-17 16:39:55","city_state":"","city_state_abbreviation":""},{"venue_id":"6725","name":"Ford Field","city_id":"49","city_name":"Detroit, MI","area_name":"United States","area_id":"203","address":"2000 Brush Street","address_zip":"48226","opened":"2002","status":"open","nicknames":"","geo_latitude":"42.340013453186586","geo_longitude":"-83.04564356803894","capacity":"65000","surface":"artificial turf","last_updated":"2016-11-21 20:00:21","city_state":"","city_state_abbreviation":""},{"venue_id":"6726","name":"Raymond James Stadium","city_id":"143","city_name":"Tampa, FL","area_name":"United States","area_id":"203","address":"4201 North Dale Mabry Highway","address_zip":"33607","opened":"1998","status":"open","nicknames":"Ray Jay, The New Sombrero","geo_latitude":"27.97597863170003","geo_longitude":"-82.50329554080963","capacity":"65890","surface":"grass","last_updated":"2016-11-21 20:01:05","city_state":"","city_state_abbreviation":""},{"venue_id":"6727","name":"Hard Rock Stadium","city_id":"19397","city_name":"Miami Gardens, FL","area_name":"United States","area_id":"203","address":"2269 Dan Marino Boulevard","address_zip":"33169","opened":"1987","status":"open","nicknames":"Sun Life Stadium, New Miami Stadium","geo_latitude":"25.95791926933141","geo_longitude":"-80.23884057998657","capacity":"74916","surface":"grass","last_updated":"2016-11-21 20:02:06","city_state":"","city_state_abbreviation":""},{"venue_id":"7875","name":"Huntington Bank Field","city_id":"37","city_name":"Cleveland, OH","area_name":"United States","area_id":"203","address":"100 Alfred Lerner Way","address_zip":"","opened":"1999","status":"open","nicknames":"FirstEnergy Stadium","geo_latitude":"41.506111","geo_longitude":"-81.699444","capacity":"67431","surface":"grass","last_updated":"2025-05-15 09:11:56","city_state":"","city_state_abbreviation":""},{"venue_id":"9102","name":"Caesars Superdome","city_id":"111","city_name":"New Orleans, LA","area_name":"United States","area_id":"203","address":"1500 Sugar Bowl Drive","address_zip":"70112","opened":"1975","status":"open","nicknames":"Louisiana Superdome, The Superdome","geo_latitude":"29.951023015900095","geo_longitude":"-90.08117524232783","capacity":"73208","surface":"artificial turf","last_updated":"2022-12-09 11:11:52","city_state":"","city_state_abbreviation":""},{"venue_id":"9231","name":"Mercedes-Benz Stadium","city_id":"11","city_name":"Atlanta, GA","area_name":"United States","area_id":"203","address":"1 AMB Drive North West","address_zip":"30313","opened":"2017","status":"open","nicknames":"New Atlanta Stadium","geo_latitude":"33.75540617490541","geo_longitude":"-84.40107526322936","capacity":"71000","surface":"artificial turf","last_updated":"2017-09-13 20:37:58","city_state":"","city_state_abbreviation":""},{"venue_id":"10427","name":"Croke Park","city_id":"50","city_name":"Dublin","area_name":"Republic of Ireland","area_id":"98","address":"Russell Street","address_zip":"D03 P6K7","opened":"1884","status":"open","nicknames":"Páirc an Chrócaigh","geo_latitude":"53.36079365387965","geo_longitude":"-6.251145601272583","capacity":"82300","surface":"grass","last_updated":"2019-07-04 11:43:02","city_state":"","city_state_abbreviation":""},{"venue_id":"11523","name":"Lucas Oil Stadium","city_id":"74","city_name":"Indianapolis, IN","area_name":"United States","area_id":"203","address":"500 South Capitol Avenue","address_zip":"46225","opened":"2008","status":"open","nicknames":"","geo_latitude":"39.7601048","geo_longitude":"-86.1660764","capacity":"67000","surface":"artificial turf","last_updated":"2018-03-23 19:00:45","city_state":"","city_state_abbreviation":""},{"venue_id":"11727","name":"Acrisure Stadium","city_id":"122","city_name":"Pittsburgh, PA","area_name":"United States","area_id":"203","address":"100 Art Rooney Avenue","address_zip":"","opened":"2001","status":"open","nicknames":"","geo_latitude":"40.446667","geo_longitude":"-80.015833","capacity":"69690","surface":"grass","last_updated":"2022-12-29 15:59:13","city_state":"","city_state_abbreviation":""},{"venue_id":"11728","name":"Lambeau Field","city_id":"67","city_name":"Green Bay, WI","area_name":"United States","area_id":"203","address":"1265 Lombardi Avenue","address_zip":"","opened":"1957","status":"open","nicknames":"The Frozen Tundra","geo_latitude":"44.501389","geo_longitude":"-88.062222","capacity":"81441","surface":"grass","last_updated":"2018-04-18 11:23:11","city_state":"","city_state_abbreviation":""},{"venue_id":"11729","name":"Highmark Stadium","city_id":"115","city_name":"Orchard Park, NY","area_name":"United States","area_id":"203","address":"1 Bills Drive","address_zip":"14127","opened":"1973","status":"open","nicknames":"The Ralph, Bills Stadium","geo_latitude":"42.774","geo_longitude":"-78.787","capacity":"71608","surface":"artificial turf","last_updated":"2023-05-26 12:03:42","city_state":"","city_state_abbreviation":""},{"venue_id":"11730","name":"Paycor Stadium","city_id":"34","city_name":"Cincinnati, OH","area_name":"United States","area_id":"203","address":"1 Paul Brown Stadium","address_zip":"","opened":"2000","status":"open","nicknames":"The Jungle, PBS, Paul Brown Stadium","geo_latitude":"39.095","geo_longitude":"-84.516","capacity":"65515","surface":"artificial turf","last_updated":"2023-08-04 12:34:54","city_state":"","city_state_abbreviation":""},{"venue_id":"11731","name":"U.S. Bank Stadium","city_id":"102","city_name":"Minneapolis, MN","area_name":"United States","area_id":"203","address":"401 Chicago Avenue","address_zip":"","opened":"2016","status":"open","nicknames":"The Ship","geo_latitude":"44.974","geo_longitude":"-93.258","capacity":"66655","surface":"artificial turf","last_updated":"2018-04-18 11:47:33","city_state":"","city_state_abbreviation":""},{"venue_id":"12597","name":"Tottenham Hotspur Stadium","city_id":"912","city_name":"Haringey, Borough of London","area_name":"England","area_id":"68","address":"782 High Road","address_zip":"N17 0BX","opened":"2018","status":"open","nicknames":"New White Hart Lane","geo_latitude":"51.60475","geo_longitude":"-0.066417","capacity":"62062","surface":"grass","last_updated":"2024-06-17 17:09:33","city_state":"","city_state_abbreviation":""},{"venue_id":"16567","name":"SoFi Stadium","city_id":"11282","city_name":"Inglewood, CA","area_name":"United States","area_id":"203","address":"1000 S Prairie Ave","address_zip":"90301","opened":"2020","status":"open","nicknames":"","geo_latitude":"33.9533893","geo_longitude":"-118.3409007","capacity":"70240","surface":"artificial turf","last_updated":"2020-05-11 13:38:03","city_state":"","city_state_abbreviation":""},{"venue_id":"16568","name":"Allegiant Stadium","city_id":"89","city_name":"Las Vegas, NV","area_name":"United States","area_id":"203","address":"3333 Al Davis Way","address_zip":"89118","opened":"2020","status":"open","nicknames":"","geo_latitude":"36.0908706","geo_longitude":"-115.185388","capacity":"65000","surface":"grass","last_updated":"2020-05-11 13:41:01","city_state":"","city_state_abbreviation":""}]}}