NFL API: Get scores
Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
Unofficial. Not affiliated with or endorsed by NFL.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date Date in the NFL week to view, such as 2026-09-28. Defaults to the current week.
2026-10-04
- Team optional
team Team name to keep, such as Dallas Cowboys or Cowboys.
Not set
- Time Zone optional
time_zone Time zone for kickoff times, such as US Eastern, America/Chicago or UTC.
America/Los_Angeles
Default
US Eastern.
Input as JSON
{ "date": "2026-10-04", "time_zone": "America/Los_Angeles" }Output
{ "games": [ { "city": "Cleveland", "clock": null, "status": "final", "game_id": "aa29da01-4feb-11f1-abca-2c54536568a9", "quarter": null, "stadium": "Huntington Bank Field", "away_team": "Pittsburgh Steelers", "game_link": "https://www.nfl.com/games/steelers-at-browns-2026-reg-4" , "home_team": "Cleveland Browns", "away_score": 24, "home_score": 27, "tv_network": "Prime Video", "kickoff_time": "2026-10-01T17:15:00-07:00" }, { "city": "London", "clock": null, "status": "final", "game_id": "aa29dd21-4feb-11f1-abca-2c54536568a9", "quarter": null, "stadium": "Tottenham Hotspur Stadium", "away_team": "Indianapolis Colts", "game_link": "https://www.nfl.com/games/colts-at-commanders-2026-reg-4" , "home_team": "Washington Commanders", "away_score": 30, "home_score": 13, "tv_network": "NFL NETWORK", "kickoff_time": "2026-10-04T06:30:00-07:00" }, { "city": "Baltimore", "clock": null, "status": "final", "game_id": "aa4b4811-4feb-11f1-abca-2c54536568a9", "quarter": null, "stadium": "M&T Bank Stadium", "away_team": "Tennessee Titans", "game_link": "https://www.nfl.com/games/titans-at-ravens-2026-reg-4" , "home_team": "Baltimore Ravens", "away_score": 18, "home_score": 24, "tv_network": "CBS", "kickoff_time": "2026-10-04T10:00:00-07:00" } ], "season": 2026, "week_label": "Week 4"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nfl.com/get_scores","input":{"date":"2026-10-04","time_zone":"America/Los_Angeles"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "nfl.com/get_scores" , "input": { "date": "2026-10-04", "time_zone": "America/Los_Angeles" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "nfl.com/get_scores" , "input": { "date": "2026-10-04", "time_zone": "America/Los_Angeles" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run nfl.com/get_scores# with {"date":"2026-10-04","time_zone":"America/Los_Angeles"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "date": { "type": "string", "description": "Date in the NFL week to view, such as 2026-09-28. Defaults to the current week." }, "team": { "type": "string", "description": "Team name to keep, such as Dallas Cowboys or Cowboys." }, "time_zone": { "type": "string", "default": "US Eastern", "description": "Time zone for kickoff times, such as US Eastern, America/Chicago or UTC." } }}Output schema
{ "type": "object", "required": [ "season", "week_label", "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "properties": { "city": { "type": [ "string", "null" ] }, "clock": { "type": [ "string", "null" ] }, "status": { "enum": [ "scheduled", "live", "final" ], "type": "string" }, "game_id": { "type": "string" }, "quarter": { "type": [ "string", "null" ] }, "stadium": { "type": [ "string", "null" ] }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_team": { "type": "string" }, "away_score": { "type": [ "integer", "null" ] }, "home_score": { "type": [ "integer", "null" ] }, "tv_network": { "type": [ "string", "null" ] }, "kickoff_time": { "type": [ "string", "null" ] } } } }, "season": { "type": "integer" }, "week_label": { "type": [ "string", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nfl.com/get_scores- Returns
- season, week label, games with teams, scores, status, kickoff, TV, venue, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nfl.com/get_scores with the inputs above.
Ask your agent
- What were the NFL scores for the week of October 4, 2026?
- Show me Cowboys games and final scores on nfl.com for the week of 2026-09-28.
- Can you list this week's NFL games with kickoff times in Chicago time?
- Give me the Packers schedule and results for the week containing 2026-11-15, with kickoffs in UTC.
- Which NFL games are on TV this Sunday, and what are the scores so far?
See more
All NFL methodsGets NFL regular-season standings by conference and division for a season, with clinch status when shown.
nfl.com/get_standingsGets an NFL team's current NFL.com roster by team name, nickname or city. You can limit it to offense, defense or special teams. Released players are left out.
nfl.com/get_team_rosterGets a named NFL player's season and career stats, with profile details. Active players are preferred when names match.
nfl.com/get_player_statsLists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.
nhl.com/get_scoresGets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
sports.yahoo.com/get_scoresGets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone.
espn.com/get_scoresGets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.
nba.com/get_scoresLists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
mlb.com/get_scores