NFL API
Realtime Sports API serves NFL games through the same REST endpoints and JSON schema as every other league, using sport=football and league=nfl. You get the current scoreboard, live scores, game detail, play-by-play, teams, rosters and news, plus current odds and line history from a single source book and the injury report. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
- Slugs
- sport=football
league=nfl - Teams
- 32
- Season (from data)
- 2026 Regular Season
- In the scoreboard now
- 13 games
Upcoming and live NFL games
| Date | Away | Home | Time / Result | TV | Venue |
|---|---|---|---|---|---|
| Sun, Nov 22 | Arizona Cardinals | atKansas City Chiefs | 1:00 PM ET | TV: CBS | Arrowhead Stadium · Kansas City, MO |
| Sun, Nov 22 | Baltimore Ravens | atCarolina Panthers | 1:00 PM ET | TV: Fox | Bank of America Stadium · Charlotte, NC |
| Sun, Nov 22 | Miami Dolphins | atBuffalo Bills | 1:00 PM ET | TV: CBS | Highmark Stadium · Orchard Park, NY |
| Sun, Nov 22 | New Orleans Saints | atChicago Bears | 1:00 PM ET | TV: Fox | Soldier Field · Chicago, IL |
| Sun, Nov 22 | Tampa Bay Buccaneers | atDetroit Lions | 1:00 PM ET | TV: Fox | Ford Field · Detroit, MI |
| Sun, Nov 22 | Tennessee Titans | atDallas Cowboys | 1:00 PM ET | TV: Fox | AT&T Stadium · Arlington, TX |
| Sun, Nov 22 | Pittsburgh Steelers | atPhiladelphia Eagles | 1:00 PM ET | TV: CBS | Lincoln Financial Field · Philadelphia, PA |
| Sun, Nov 22 | New York Jets | atLos Angeles Chargers | 4:05 PM ET | TV: Fox | SoFi Stadium · Inglewood, CA |
From the /events endpoint for this league, refreshed every few minutes. Times are US Eastern. Full NFL schedule · NFL team APIs · Free NFL scoreboard widget
Live example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=1"Response captured from live data at 2026-11-21 21:00 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.
Response
{
"success": true,
"data": [
{
"id": "401873066",
"uid": "s:20~l:28~e:401873066",
"name": "Indianapolis Colts at Houston Texans",
"shortName": "IND @ HOU",
"date": "2026-11-20T01:15Z",
"status": {
"state": "post",
"completed": true,
"period": 4,
"clock": "0:00",
"detail": "Final",
"halftime": false,
"firstHalfEnded": true
},
"homeTeam": {
"id": "34",
"name": "Houston Texans",
"abbreviation": "HOU",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0HVl9AUlxGC0IcSkoYVg",
"color": "021018",
"alternateColor": "eb0028",
"winner": true,
"score": 26
},
"awayTeam": {
"id": "11",
"name": "Indianapolis Colts",
"abbreviation": "IND",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0HVl9AUlxGCkMNSkoYVg",
"color": "003b75",
"alternateColor": "ffffff",
"winner": false,
"score": 3
},
"competition": {
"attendance": 70942,
"neutralSite": false,
"conferenceCompetition": false,
"divisionCompetition": false,
"playByPlayAvailable": true,
"highlightsAvailable": true
},
"venue": {
"id": "3891",
"name": "Reliant Stadium",
"city": "Houston",
"state": "TX",
"indoor": true,
"grass": false
},
"notes": [],
"season": {
"year": 2026,
"displayName": "2026",
"type": {
"id": "2",
"name": "Regular Season",
"abbreviation": "reg"
},
"week": {
"number": 11,
"startDate": "2026-11-18T08:00Z",
"endDate": "2026-11-25T07:59Z",
"text": "Week 11"
}
},
"broadcasts": [
{
"network": "Prime Video",
"type": "Streaming"
}
],
"officials": [
{
"id": "17664",
"fullName": "Dino Paganelli",
"displayName": "Dino Paganelli",
"order": 2,
"position": "Back Judge"
},
{
"id": "17671",
"fullName": "Dyrol Prioleau",
"displayName": "Dyrol Prioleau",
"order": 3,
"position": "Field Judge"
},
{
"id": "17676",
"fullName": "Jeff Seeman",
"displayName": "Jeff Seeman",
"order": 1,
"position": "Line Judge"
},
"... 4 more"
]
}
],
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}NFL play-by-play example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events/401873066/plays?limit=3"Response captured from live data at 2026-11-21 20:36 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Plays from Indianapolis Colts at Houston Texans.
Response
{
"success": true,
"data": [
{
"id": "4018730661",
"sequenceNumber": "100",
"text": "GAME",
"shortText": "Game",
"alternativeText": "GAME",
"type": {
"id": "70",
"text": "Coin Toss"
},
"period": 1,
"clock": {
"value": 900,
"displayValue": "15:00"
},
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": {
"down": 0,
"distance": 0,
"yardLine": 0,
"yardsToEndzone": 0
},
"endSituation": {
"down": 0,
"distance": 0,
"yardLine": 0,
"yardsToEndzone": 65
},
"yardsGained": 0,
"athletes": [],
"priority": false,
"modified": "2026-11-20T04:13Z"
},
{
"id": "40187306640",
"sequenceNumber": "4000",
"text": "K.Fairbairn kicks 65 yards from HST 35 to IND 0. S.McGowan ran ob at IND 40 for 40 yards (J.Smith). HST-C.Braswell was injured during the play.",
"shortText": "Ka'imi Fairbairn 65 Yd Kickoff Seth McGowan 40 Yd Kickoff Return",
"alternativeText": "K.Fairbairn kicks 65 yards from HST 35 to IND 0. S.McGowan ran ob at IND 40 for 40 yards (J.Smith). HST-C.Braswell was injured during the play.",
"type": {
"id": "53",
"text": "Kickoff",
"abbreviation": "K"
},
"period": 1,
"clock": {
"value": 900,
"displayValue": "15:00"
},
"wallClock": "2026-11-20T01:15:44Z",
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": {
"down": 0,
"distance": 0,
"yardLine": 35,
"yardsToEndzone": 65
},
"endSituation": {
"down": 1,
"distance": 10,
"yardLine": 60,
"yardsToEndzone": 60
},
"yardsGained": 40,
"athletes": [
{
"id": "2971573",
"name": "Ka'imi Fairbairn",
"displayName": "Ka'imi Fairbairn",
"shortName": "K. Fairbairn",
"position": "PK",
"team": {
"id": "34"
},
"role": "kicker",
"type": "kicker",
"order": 1
},
{
"id": "4686468",
"name": "Seth McGowan",
"displayName": "Seth McGowan",
"shortName": "S. McGowan",
"position": "RB",
"team": {
"id": "11"
},
"role": "returner",
"type": "returner",
"order": 2
},
{
"id": "4594277",
"name": "Jaylin Smith",
"displayName": "Jaylin Smith",
"shortName": "J. Smith",
"position": "CB",
"team": {
"id": "34"
},
"role": "tackler",
"type": "tackler",
"order": 3
}
],
"priority": false,
"modified": "2026-11-20T04:13Z"
},
{
"id": "40187306658",
"sequenceNumber": "5800",
"text": "Official Timeout at 14:54.",
"shortText": "Official Timeout At 14:54. ",
"alternativeText": "Official Timeout at 14:54.",
"type": {
"id": "74",
"text": "Official Timeout",
"abbreviation": "Off TO"
},
"period": 1,
"clock": {
"value": 894,
"displayValue": "14:54"
},
"wallClock": "2026-11-20T01:18:38Z",
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": {
"down": 1,
"distance": 10,
"yardLine": 60,
"yardsToEndzone": 0,
"downDistanceText": "1st & 10 at IND 40",
"possessionText": "IND 40"
},
"endSituation": {
"down": 1,
"distance": 10,
"yardLine": 60,
"yardsToEndzone": 60
},
"yardsGained": 0,
"athletes": [],
"priority": false,
"modified": "2026-11-20T04:13Z"
}
],
"meta": {
"pagination": {
"page": 1,
"pageSize": 3,
"total": 160,
"totalPages": 54,
"hasNextPage": true,
"hasPreviousPage": false
},
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}Play-by-play API reference · Paid plans can receive each play as it happens over WebSocket or webhooks instead of polling.
NFL box score example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events/401873066/boxscore"Response captured from live data at 2026-11-21 20:36 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Box score for Indianapolis Colts at Houston Texans; player lists trimmed to 2 of 31 (home) and 32 (away).
Response
{
"success": true,
"data": {
"homeTeam": {
"id": "34",
"name": "Houston Texans",
"abbreviation": "HOU",
"score": 26
},
"awayTeam": {
"id": "11",
"name": "Indianapolis Colts",
"abbreviation": "IND",
"score": 3
},
"homePlayers": [
{
"id": "4432577",
"name": "C.J. Stroud",
"jersey": "7",
"categories": {
"passing": {
"completions/passingAttempts": "21/27",
"passingYards": "194",
"yardsPerPassAttempt": "7.2",
"passingTouchdowns": "3",
"interceptions": "1",
"sacks-sackYardsLost": "1-7",
"adjQBR": "79.8",
"QBRating": "118.2"
},
"rushing": {
"rushingAttempts": "6",
"rushingYards": "27",
"yardsPerRushAttempt": "4.5",
"rushingTouchdowns": "0",
"longRushing": "26"
}
}
},
{
"id": "4035538",
"name": "David Montgomery",
"jersey": "32",
"categories": {
"rushing": {
"rushingAttempts": "26",
"rushingYards": "107",
"yardsPerRushAttempt": "4.1",
"rushingTouchdowns": "0",
"longRushing": "15"
},
"receiving": {
"receptions": "3",
"receivingYards": "17",
"yardsPerReception": "5.7",
"receivingTouchdowns": "0",
"longReception": "9",
"receivingTargets": "4"
}
}
}
],
"awayPlayers": [
{
"id": "3917792",
"name": "Daniel Jones",
"jersey": "17",
"categories": {
"passing": {
"completions/passingAttempts": "12/27",
"passingYards": "144",
"yardsPerPassAttempt": "5.3",
"passingTouchdowns": "0",
"interceptions": "1",
"sacks-sackYardsLost": "2-15",
"adjQBR": "14.0",
"QBRating": "45.9"
},
"rushing": {
"rushingAttempts": "1",
"rushingYards": "3",
"yardsPerRushAttempt": "3.0",
"rushingTouchdowns": "0",
"longRushing": "3"
}
}
},
{
"id": "4429084",
"name": "Anthony Richardson Sr.",
"jersey": "5",
"categories": {
"passing": {
"completions/passingAttempts": "0/2",
"passingYards": "0",
"yardsPerPassAttempt": "0.0",
"passingTouchdowns": "0",
"interceptions": "0",
"sacks-sackYardsLost": "0-0",
"adjQBR": "4.3",
"QBRating": "39.6"
},
"rushing": {
"rushingAttempts": "1",
"rushingYards": "2",
"yardsPerRushAttempt": "2.0",
"rushingTouchdowns": "0",
"longRushing": "2"
}
}
}
],
"periodScores": {
"home": [
7,
10,
9,
"... 1 more"
],
"away": [
3,
0,
0,
"... 1 more"
]
}
},
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}Build with the NFL API
NFL endpoints
Checked against live data on 2026-10-04. Paths are relative to /api/v1/sports/football/leagues/nfl.
| Endpoint | Path | NFL | Notes |
|---|---|---|---|
| Live scores | /events/live | Available | |
| Events (scoreboard) | /events | Available | |
| Event detail | /events/{eventId} | Available | |
| Play-by-play | /events/{eventId}/plays | Available | |
| Box score | /events/{eventId}/boxscore | Available | |
| Odds | /events/{eventId}/odds | Available | |
| Win probability | /events/{eventId}/winprobability | Available | |
| Teams | /teams | Available | |
| Rosters | /teams/{teamId}/roster | Available | |
| Athletes | /athletes/search | Available | |
| Injuries | /injuries | Available | |
| News | /news | Available | |
| Schedule / weeks | /seasons/{season}/schedule | Available | |
| NCAA tournament | /seasons/{season}/tournament | Not available | |
| Rankings | /rankings | Not available | |
| Webhooks | /webhooks | Available | |
| WebSocket | /websocket/auth | Available |
- Week-based season: list weeks with /seasons/{season}/weeks and fetch one week with /seasons/{season}/schedule?week=N (NFL and the other football league only).
Every NFL game in the events, live and schedule endpoints uses the same Event object as other leagues: Event object field reference.
NFL API in Python, JavaScript and curl
curl
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=5"JavaScript (fetch)
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=5", {
headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);Python (requests)
import os, requests
res = requests.get(
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=5",
headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
timeout=10,
)
body = res.json()
print(body["data"])MCP prompt (Claude, Cursor, ChatGPT)
Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_events with sport "football" and league "nfl" and list the games it returns with start times, status and scores for NFL.Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.
Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans
Real-time NFL push: WebSocket and webhooks
Instead of polling, paid plans can receive every NFL game start, score change and final as it is detected (typically 20-30 seconds behind live play): a NFL WebSocket feed for live dashboards and apps, or NFL webhooks that POST each event to your server. On the Free plan you can watch the stream and send yourself a sample webhook from the dashboard.
Shipping a product with NFL data?
Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.
- Score alerts for your sports app, without pollingWebhooks into your backend, then FCM/APNs · Starter ($29/mo)
- Live scoreboards and game pages for news and media sitesCached REST on your server; optional WebSocket for live ticks · Starter ($29/mo)
- Player stats and box scores for fantasy platformsREST box scores during games, webhooks for finals and plays · Growth ($49/mo)
- Live scores on the screens in your venueFree widget, or one WebSocket feeding every screen · Starter ($29/mo)
- A play-by-play feed for your analytics stackWebSocket for live plays, REST to backfill and reconcile · Growth ($49/mo)
- Stream live scores to your backend over WebSocketWebSocket (server to server) · Starter ($29/mo)
- Sports data for a startup, from prototype to scaleREST, WebSocket and webhooks on one key · Starter ($29/mo)
NFL API pricing and rate limits
The NFL API is included in every plan, Free included: one key covers all leagues. Free starts with 1,000 calls in your first 30 days (no card); paid plans start at $29/month with a 7-day free trial.
| Plan | Price | Calls | Rate | WebSocket | Webhooks |
|---|---|---|---|---|---|
| Free | $0 | 125/mo (1,000 first 30 days) | 1/s | 500 msgs/mo | No |
| Starter | $29/mo ($290/yr) | 10,000/mo | 5/s | Shares monthly pool | Shares monthly pool |
| Growth | $49/mo ($490/yr) | 25,000/mo | 10/s | Shares monthly pool | Shares monthly pool |
| Pro | $99/mo ($990/yr) | 50,000/mo | 20/s | 100,000 msgs/mo | 25,000/mo |
| Business | $179/mo ($1,790/yr) | 150,000/mo | 40/s | 300,000 msgs/mo | 75,000/mo |
| Scale | $299/mo ($2,990/yr) | 500,000/mo | 100/s | 500,000 msgs/mo | 100,000/mo |
Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.
29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.
FAQ
- Is there a free NFL API?
- Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. The same key works for all 29 leagues.
- How fresh is the NFL data?
- Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA. It is not intended for in-play betting that needs sub-second data.
- Which NFL endpoints are available?
- Available: live scores, events (scoreboard), event detail, play-by-play, box score, odds, win probability, teams, rosters, athletes, injuries, news, schedule / weeks. Not available or not verified: ncaa tournament (not available), rankings (not available).
- Does the NFL API include betting odds?
- Yes. Upcoming NFL games returned a spread, moneyline and total when we checked, from a single source book, with line history. It is not a multi-book comparison feed and not suited to sub-second in-play betting.
- Does it include NFL injuries?
- Yes. The injuries endpoint returned current NFL designations grouped by team, and player-availability normalizes them to values like OUT and QUESTIONABLE. Pass team for a complete team report.
- Can I get NFL score updates pushed instead of polling?
- Yes. Webhooks are included on every paid plan (Starter, Growth, Pro, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview. Both can be filtered to nfl.