NFL Data Feed
NFL Data Feed
https://www.goalserve.com/getfeed/---------/football/nfl-scores?json=1
https://www.goalserve.com/getfeed/---------/football/fbs-scores?json=1
all ID values are always static and not change every season
all ID values are unique in single sport scope, not globally
1) COVERAGE LIST FEED
https://www.goalserve.com/getfeed/---------/football/coverage
id int tournament id
country string country name
name String tournament name
<schedule>
leagues standings feed. League teams list feed that show all teams in the league
<livescore>
https://www.goalserve.com/getfeed/---------/football/nfl-shedule
https://www.goalserve.com/getfeed/---------/football/fbs-shedule
https://www.goalserve.com/getfeed/---------/football/fcs-shedule
https://www.goalserve.com/getfeed/---------/football/div3-shedule
id int tournament id
name string tournament stage name. Possible values:
Pre Season
Regular Season
Post Season
<week name="1">
<week name="Wild Card">
name String week name. Possible values can be numeric (1,2,3,4 etc.) or
string
Wild Card
Divisional Round
Conference Championships
Pro Bowl
Super Bowl
Bowls – for all College bowls matches
EST
EDT
formatted_date date (d.MM.yyyy) match start date
Not Started
Postponed
Cancelled
Final
datetime_utc datetime match start datetime in UTC timezone
(dd.MM.yyyy HH:mm)
3) LEAGUE STANDINGS FEED (LEAGUE TEAMS)
URL format
https://www.goalserve.com/getfeed/---------/football/nfl-standings
https://www.goalserve.com/getfeed/---------/football/fbs-standings
conference element
name string conference name
<division name="North">
<team position="1" name="Buffalo Bills" won="1" lost="1" ties="0" win_percentage=".500" home_record="0-1" road_record="1-0"
division_record="1-0" conference_record="1-1" points_for="51" points_against="23" difference="+28" streak="W1" id="1689" />
URL format
https://www.goalserve.com/getfeed/---------/football/1698_rosters
<position name="Offense">
Offense
Defense
Special Teams
<player number="7" name="Kurt Benkert" position="QB" age="26" height="6' 3"" weight="218 lbs" experience_years="2"
college="Virginia" salarycap="$165,600" id="3040535" />
QB Quarterback
RB Running Back
FB Fullback
WR Wide Receiver
TE Tight End
OL Offensive Lineman
C Center
G Guard
LG Left Guard
RG Right Guard
T Tackle
LT Left Tackle
RT Right Tackle
PK Kicker
DL Defensive Lineman
DE Defensive End
DT Defensive Tackle
NT Nose Tackle
LB Linebacker
P Punter
LS Long Snapper
age string player age in years
height string player hight in feets
weight string player weight in pounds
experience_years string number of years of experience in NFL league
salarycap string player yearly salary info
id string player id
<image>
team logo image in .png format encoded in base64 string
https://stackoverflow.com/questions/55795998/how-to-fully-decode-a-base64-string-in-php
5) TEAM SEASON PLAYER STATS FEED
URL format
<category name="Passing">
Passing
Rushing
Receiving
Defence
Scoring
Returning
Kicking
Punting
Passing statistics:
Rushing statistics:
Receiving statistics:
Scoring statistics:
Kicking statistics:
Punting statistics:
URL format
<category name="Passing">
Passing
Rushing
Downs
Kicking
Returning
Every statistic section is divided into 2 parts. Team statistics gained and the opposite teams statistics allowed by the team.
<team ...>
team statistics
<opponents ...>
Passing statistics:
Rushing statistics:
Downs statistics:
Returning statistics:
Kicking statistics:
URL format
URL format
<hometeam name="Chicago Bears" drive="" ball_on="" q1="7" q2="0" q3="0" q4="13" ot="" totalscore="20" number="0" id="1703" />
<team_stats>
<hometeam>
<first_downs total="16" passing="7" rushing="6" from_penalties="3" third_down_efficiency="6-15" fourth_down_efficiency="0-1" />
<plays total="61" />
<yards total="206" yards_per_play="10" total_drives="3.4" />
<passing total="83" comp_att="15-24" yards_per_pass="3.1" interceptions_thrown="1" sacks_yards_lost="3-33" />
<rushings total="123" attempts="34" yards_per_rush="3.6" />
<red_zone made_att="1-3" />
<penalties total="8-70" />
<turnovers total="1" lost_fumbles="0" interceptions="1" />
<posession total="31:21" />
<interceptions total="3" />
<fumbles_recovered total="1" />
<sacks total="4" />
<safeties total="0" />
<int_touchdowns total="1" />
<points_against total="17" />
</hometeam>
<awayteam> </awayteam>
</team_stats>
<player name="Tashaun Gipson Sr." total="0" lost="0" rec="1" rec_td="0" id="15235" />
<player name="Darnell Mooney" total="1" yards="10" average="10.0" lg="10" td="0" kick_return_td="0" exp_return_td="0" id="4040655" />
<player name="Darius Phillips" total="1" yards="15" average="15.0" lg="15" td="0" id="3042785" />
<player name="Pat O'Donnell" total="4" yards="169" average="42.3" touchbacks="1" in20="2" lg="47" id="16863" />
By date – return matches for a given date. History is available starting from 01.01.2010.
https://www.goalserve.com/getfeed/--------- /football/nfl-scores?date=19.09.2021
URL format
Drive element:
<drive team="hometeam" name="Chicago Bears" minute="5:02" totals="9 plays, 75 yards, 5:02" id="9661721">
</drive>
drive information
<play minute="11:53 - 3rd" down="2nd & 4 at BAL 40" description="Byron Pringle Pass From Patrick Mahomes for 40 Yrds H.Butker extra
point is GOOD, Center-J.Winchester, Holder-T.Townsend." localscore="17" awayscore="27" type="PASS TD" yards="40 Yrds" penalty="False"
pl_id1="4036416" pl_id2="3139477" pl_id3="" pl_id4="" id="1156492" />
Drive events:
PASS
RUSH
SACK
PENALTY
FUMBLE
FUMBLE REC
Scoring events:
TD - touchdown
PASS TD – pass reception TD
RUSH TD – rushing TD
INT TD – interception return TD
FUMBLE REC TD – fumble recovery return TD
KICK REC TD – blocked kick return TD
FG – successful field goal attempt
FG BLOCKED – blocked field goal attempt
2PT – successful 2 point conversion attempt
EXTRAPOINT – succesful extra point attempt
Kicking events:
KICK
PUNT
By date – return matches for a given date. History is available starting from 01.01.2010.
https://www.goalserve.com/getfeed/--------- /football/nfl-scores?date=19.09.2021_pbp
https://www.goalserve.com/getfeed/--------- /football/fbs-scores?date=19.09.2021_pbp
URL format
https://www.goalserve.com/getfeed/---------/football/nfl-shedule?showodds=1
https://www.goalserve.com/getfeed/---------/football/fbs-shedule?showodds=1
https://www.goalserve.com/getfeed/---------/football/nfl-
shedule?date1=17.11.2021&date2=20.11.2021&showodds=1
this is the main feed which return all possible bets/bookmakers. It contain all available bookmakers/markets. Feed
can have large file size. Apply GZIP compression in your parser to minimize bandwidth and speed up download.
contentEncondings.add( "gzip" );
httpHeaders.put( "Content-Encoding", contentEncondings );
context.put( MessageContext.HTTP_REQUEST_HEADERS, httpHeaders );
Not Started
Postponed
Cancelled
Final
datetime_utc datetime match start datetime in UTC timezone
(dd.MM.yyyy HH:mm)
Available markets list with ID (New markets can appear in the feed any time. To get updated
please always read feed for new markets ids and save them if they will appear):
market ID market name
1 Home/Away (Moneyline)
4 Handicap (Spread)
3 Over/Under (Totals)
5 1st Half Winner
7 1st Half Goals Over/Under
8 2nd Half Goals Over/Under
9 1st Half Handicap
10 2nd Half Handicap
12 HT/FT Double
55 2nd Half Winner
91 Highest Scoring Half
111 Margin Betting
2211 1st Scoring Play
2216 1st Team Touchdown
2226 Race To 20
2232 Race To 10
2266 Race To 25
2267 1st Quarter Winner
2268 2nd Quarter Winner
2273 3rd Quarter Winner
2274 4thQuarter Winner
2275 1st Quarter Total
2276 2nd Quarter Total
2279 Highest Scoring Quarter
2290 Race To 15
22120 Race To 30
22121 Race To 40
22124 Total - Home
22125 Total - Away
22126 Win Both Halves – Home
22127 Win Both Halves – Away
22161 First Touchdown Scorer
22162 Last Touchdown Scorer
22163 Anytime Touchdown Scorer
22178 Team With Longest Field Goal
22183 Will The Game Go To Overtime
22262 Touchdown – Home
22263 Touchdown – Away
22366 Tri-Bets 7.5
22601 Handicap 1st Qtr
22602 Handicap 2nd Qtr
bookmaker node
Available bookmaker list with ID (New bookmakers can appear in the feed any time. To get updated
please always read feed for new bookmaker ids and save them if they will appear):
bookmaker ID bookmaker ID
14 10bet
20 5 Dimes
470 Ballybet
463 Barstool
3 Bet At Home
32 Betclic
21 Betfair Exchange
453 BetMGM
206 Betonline
460 Betrivers
43 Betsson
191 BetUS
158 Betway
87 Bodog
454 Borgota
2 bwin
453 Caesars
461 Casumo
5 Coral
232 Dafabet
455 Draftkings
469 Elite
451 Fanduel
464 FOXbet
226 Marathonbet
260 Mybookie
256 Neds
458 Parx
502 Pinnacle
452 PointsBet
179 Sbobet
93 Skybook
229 Sportsbet
457 SugarHouse
468 theScore
459 TwinSpires
82 Unibet
335 WagerBet
15 William Hill
243 Winlinebet
466 WynnBet
133 You Wager
Available only for Total/Over Under markets. Additional element that show OverUnder / Total
value.
1 – main line
0 – alternative line
Available only for Handicap/Spread markets. Additional element that show Handicap/Spread value.
name string handicap value. every child odd element have additional
handicap attribute for correct handicap mapping. Example
ismain bool (0/1) flag indicate if given handicap value is main line at this
moment
1 – main line
0 – alternative line
https://www.goalserve.com/getfeed/---------/football/nfl-
shedule?date1=17.11.2021&date2=20.11.2021&showodds=1
https://www.goalserve.com/getfeed/---------/football/nfl-shedule?showodds=1&bm=82,
https://www.goalserve.com/getfeed/---------/football/ nfl-shedule?showodds=1&bm=93,82
bm – bookmaker ID
to filter by single bookmaker add “,” after bookmaker id (“showodds=1&bm=82,”)
https://www.goalserve.com/getfeed/---------/football/nfl-shedule?showodds=1&market=2,
https://www.goalserve.com/getfeed/---------/football/nfl-shedule?showodds=1&market=2,4
market – market ID
to filter by single market add “,” after market id (“showodds=1&market=2,”)
11) PLAYER IMAGES (HEADSHOTS)
https://www.goalserve.com/getfeed/---------/football/usa?playerimage=4048736
https://www.goalserve.com/getfeed/---------/football/usa?fbsplayerimage=4048736
https://www.goalserve.com/getfeed/---------/football/h2h_1690-1681
top50
overall
total number of team 1 wins, losses and team 2 wins and losses
leagues
top50