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

NFL games from the API
DateAwayHomeTime / ResultTVVenue
Sun, Nov 22Arizona CardinalsatKansas City Chiefs1:00 PM ETTV: CBSArrowhead Stadium · Kansas City, MO
Sun, Nov 22Baltimore RavensatCarolina Panthers1:00 PM ETTV: FoxBank of America Stadium · Charlotte, NC
Sun, Nov 22Miami DolphinsatBuffalo Bills1:00 PM ETTV: CBSHighmark Stadium · Orchard Park, NY
Sun, Nov 22New Orleans SaintsatChicago Bears1:00 PM ETTV: FoxSoldier Field · Chicago, IL
Sun, Nov 22Tampa Bay BuccaneersatDetroit Lions1:00 PM ETTV: FoxFord Field · Detroit, MI
Sun, Nov 22Tennessee TitansatDallas Cowboys1:00 PM ETTV: FoxAT&T Stadium · Arlington, TX
Sun, Nov 22Pittsburgh SteelersatPhiladelphia Eagles1:00 PM ETTV: CBSLincoln Financial Field · Philadelphia, PA
Sun, Nov 22New York JetsatLos Angeles Chargers4:05 PM ETTV: FoxSoFi 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
    }
  }
}

Box score API reference

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.

EndpointPathNFLNotes
Live scores/events/liveAvailable
Events (scoreboard)/eventsAvailable
Event detail/events/{eventId}Available
Play-by-play/events/{eventId}/playsAvailable
Box score/events/{eventId}/boxscoreAvailable
Odds/events/{eventId}/oddsAvailable
Win probability/events/{eventId}/winprobabilityAvailable
Teams/teamsAvailable
Rosters/teams/{teamId}/rosterAvailable
Athletes/athletes/searchAvailable
Injuries/injuriesAvailable
News/newsAvailable
Schedule / weeks/seasons/{season}/scheduleAvailable
NCAA tournament/seasons/{season}/tournamentNot available
Rankings/rankingsNot available
Webhooks/webhooksAvailable
WebSocket/websocket/authAvailable
  • 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.

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.

PlanPriceCallsRateWebSocketWebhooks
Free$0125/mo (1,000 first 30 days)1/s500 msgs/moNo
Starter$29/mo ($290/yr)10,000/mo5/sShares monthly poolShares monthly pool
Growth$49/mo ($490/yr)25,000/mo10/sShares monthly poolShares monthly pool
Pro$99/mo ($990/yr)50,000/mo20/s100,000 msgs/mo25,000/mo
Business$179/mo ($1,790/yr)150,000/mo40/s300,000 msgs/mo75,000/mo
Scale$299/mo ($2,990/yr)500,000/mo100/s500,000 msgs/mo100,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.