# NFL API

> NFL provides game scores, standings, rosters, and player stats as a workflow and API.

Get scores returns games for a date’s NFL week, optionally filtered by team and time zone. Get standings returns regular-season records by conference and division for a season. Get team roster returns players for a required team and optional unit; Get player stats returns season and career stats for a named player.

- Page: https://fous.com/workflows/nfl
- Handle: `@nfl`
- Category: [Sports](https://fous.com/workflows/category/sports)
- Source website: https://nfl.com
- Last verified: Sep 28, 2026
- Fous is not affiliated with NFL.

## Methods

### Get player stats

Operation `get_player_stats`, version 1. 1 credit per call.

Get a named NFL player’s season and career stats, with profile details. Active players are preferred when names match; only stats shown on NFL player pages are included.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `player` | string | yes | `"Josh Allen"` | Player name, for example Josh Allen. |
| `season` | integer | no | `2025` | Season starting year, for example 2025. Defaults to the latest season shown. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "player"
  ],
  "properties": {
    "player": {
      "type": "string",
      "description": "Player name, for example Josh Allen.",
      "examples": [
        "Josh Allen",
        "Myles Garrett",
        "Harrison Butker"
      ]
    },
    "season": {
      "type": "integer",
      "default": null,
      "description": "Season starting year, for example 2025. Defaults to the latest season shown.",
      "examples": [
        2025,
        2024
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "player": "Josh Allen"
    },
    {
      "player": "Myles Garrett",
      "season": 2025
    },
    {
      "player": "Harrison Butker"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Josh Allen"` |  |
| `team` | string or null | `"Buffalo Bills"` |  |
| `stats` | array |  |  |
| `stats[].group` | string | `"passing"` |  |
| `stats[].stat_name` | string | `"Completions"` |  |
| `stats[].career_value` | number | `2671` |  |
| `stats[].season_value` | number or null | `56` |  |
| `stats[].stat_abbreviation` | string | `"COMP"` |  |
| `season` | integer or null | `2026` |  |
| `position` | string or null | `"QB"` |  |
| `player_id` | string | `"josh-allen"` | NFL player profile slug. |
| `player_link` | string | `"https://www.nfl.com/players/josh-allen/"` |  |
| `jersey_number` | integer or null | `17` |  |
| `headshot_image_link` | string or null | `"https://static.www.nfl.com/image/upload/t_player_profile_landscape/t_lazy/f_auto/league/mjwbioajzldkq1vzoz2d"` |  |

**Example input**

```json
{
  "player": "Josh Allen"
}
```

**Example output**

```json
{
  "name": "Josh Allen",
  "team": "Buffalo Bills",
  "stats": [
    {
      "group": "passing",
      "stat_name": "Completions",
      "career_value": 2671,
      "season_value": 56,
      "stat_abbreviation": "COMP"
    },
    {
      "group": "passing",
      "stat_name": "Passing attempts",
      "career_value": 4174,
      "season_value": 86,
      "stat_abbreviation": "ATT"
    },
    {
      "group": "passing",
      "stat_name": "Passing yards",
      "career_value": 30888,
      "season_value": 786,
      "stat_abbreviation": "YDS"
    }
  ],
  "season": 2026,
  "position": "QB",
  "player_id": "josh-allen",
  "player_link": "https://www.nfl.com/players/josh-allen/",
  "jersey_number": 17,
  "headshot_image_link": "https://static.www.nfl.com/image/upload/t_player_profile_landscape/t_lazy/f_auto/league/mjwbioajzldkq1vzoz2d"
}
```

### Get scores

Operation `get_scores`, version 1. 1 credit per call.

Get NFL scores and scheduled games for the week containing a date, optionally filtered to one team. Kickoff times use US Eastern time unless another time zone is given.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-10-04"` | Date in the NFL week to view, such as 2026-09-28. Defaults to the current week. |
| `team` | string | no | `"Dallas Cowboys"` | Team name to keep, such as Dallas Cowboys or Cowboys. |
| `time_zone` | string | no | `"America/Los_Angeles"` | Time zone for kickoff times, such as US Eastern, America/Chicago or UTC. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date in the NFL week to view, such as 2026-09-28. Defaults to the current week.",
      "examples": [
        "2026-10-04",
        "2026-09-28",
        "2026-01-11"
      ]
    },
    "team": {
      "type": "string",
      "description": "Team name to keep, such as Dallas Cowboys or Cowboys.",
      "examples": [
        "Dallas Cowboys",
        "Carolina Panthers"
      ]
    },
    "time_zone": {
      "type": "string",
      "default": "US Eastern",
      "description": "Time zone for kickoff times, such as US Eastern, America/Chicago or UTC.",
      "examples": [
        "America/Los_Angeles"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-10-04",
      "time_zone": "America/Los_Angeles"
    },
    {
      "date": "2026-09-28",
      "team": "Dallas Cowboys"
    },
    {
      "date": "2026-01-11",
      "team": "Carolina Panthers"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `games` | array |  |  |
| `games[].city` | string or null | `"Cleveland"` |  |
| `games[].clock` | string or null |  |  |
| `games[].status` | string | `"scheduled"` |  |
| `games[].game_id` | string | `"aa29da01-4feb-11f1-abca-2c54536568a9"` |  |
| `games[].quarter` | string or null |  |  |
| `games[].stadium` | string or null | `"Huntington Bank Field"` |  |
| `games[].away_team` | string | `"Pittsburgh Steelers"` |  |
| `games[].game_link` | string | `"https://www.nfl.com/games/steelers-at-browns-2026-reg-4"` |  |
| `games[].home_team` | string | `"Cleveland Browns"` |  |
| `games[].away_score` | integer or null | `34` |  |
| `games[].home_score` | integer or null | `31` |  |
| `games[].tv_network` | string or null | `"Prime Video"` |  |
| `games[].kickoff_time` | string or null | `"2026-10-01T17:15:00-07:00"` | Kickoff time in the requested time zone (ISO 8601 with offset). |
| `season` | integer | `2026` | NFL season year. |
| `week_label` | string or null | `"Week 4"` | Name of the NFL week, or null when no week is scheduled. |

**Example input**

```json
{
  "date": "2026-10-04",
  "time_zone": "America/Los_Angeles"
}
```

**Example output**

```json
{
  "games": [
    {
      "city": "Cleveland",
      "clock": null,
      "status": "scheduled",
      "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": null,
      "home_score": null,
      "tv_network": "Prime Video",
      "kickoff_time": "2026-10-01T17:15:00-07:00"
    },
    {
      "city": "London",
      "clock": null,
      "status": "scheduled",
      "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": null,
      "home_score": null,
      "tv_network": "NFL NETWORK",
      "kickoff_time": "2026-10-04T06:30:00-07:00"
    },
    {
      "city": "Baltimore",
      "clock": null,
      "status": "scheduled",
      "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": null,
      "home_score": null,
      "tv_network": "CBS",
      "kickoff_time": "2026-10-04T10:00:00-07:00"
    }
  ],
  "season": 2026,
  "week_label": "Week 4"
}
```

### Get standings

Operation `get_standings`, version 1. 1 credit per call.

Get NFL regular-season standings by conference and division for a season. Clinch status is included when shown on the standings page.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `season` | integer | no | `2025` | Season starting year, such as 2025. Defaults to the current season. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "season": {
      "type": "integer",
      "description": "Season starting year, such as 2025. Defaults to the current season.",
      "examples": [
        2025,
        2024
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "season": 2025
    },
    {
      "season": 2024
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `teams` | array |  | Teams sorted by conference (AFC then NFC), division and division rank. |
| `teams[].team` | string |  | Team name. |
| `teams[].ties` | integer |  |  |
| `teams[].wins` | integer |  |  |
| `teams[].losses` | integer |  |  |
| `teams[].division` | string |  | Division name, such as AFC East. |
| `teams[].page_link` | string |  | Team page on NFL.com. |
| `teams[].conference` | string |  | Conference name, AFC or NFC. |
| `teams[].division_rank` | integer |  | Rank within the division. |
| `teams[].points_scored` | integer |  |  |
| `teams[].current_streak` | string or null |  | Current streak, such as Won 2, or null if unavailable. |
| `teams[].points_allowed` | integer |  |  |
| `teams[].win_percentage` | number |  | Win percentage as a decimal from 0 to 1. |
| `teams[].playoff_or_clinch_status` | string or null |  | Playoff or clinch status shown for the team, or null if none is shown. |
| `season` | integer |  | Season starting year. |

### Get team roster

Operation `get_team_roster`, version 1. 1 credit per call.

Get a team’s current NFL.com roster by team name or city, optionally limited to a unit. Players listed as released are omitted; ages may be missing when a profile does not show them.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `team` | string | yes | `"Packers"` | Team name, nickname, or city, for example Green Bay Packers or Packers. |
| `unit` | string | no | `"offense"` | Roster unit to include, for example offense. Defaults to all. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "team"
  ],
  "properties": {
    "team": {
      "type": "string",
      "description": "Team name, nickname, or city, for example Green Bay Packers or Packers.",
      "examples": [
        "Packers",
        "Green Bay Packers",
        "Buffalo"
      ]
    },
    "unit": {
      "enum": [
        "all",
        "offense",
        "defense",
        "special_teams"
      ],
      "type": "string",
      "default": "all",
      "description": "Roster unit to include, for example offense. Defaults to all.",
      "examples": [
        "offense",
        "special_teams"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "team": "Packers",
      "unit": "offense"
    },
    {
      "team": "Green Bay Packers"
    },
    {
      "team": "Buffalo",
      "unit": "special_teams"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `team` | string | `"Buffalo Bills"` |  |
| `players` | array |  |  |
| `players[].age` | integer or null | `29` |  |
| `players[].name` | string | `"Tyler Bass"` |  |
| `players[].height` | string or null | `"5 ft 10 in"` |  |
| `players[].status` | string or null | `"Active"` |  |
| `players[].college` | string or null | `"Georgia Southern"` |  |
| `players[].position` | string or null | `"Kicker"` |  |
| `players[].player_link` | string | `"https://www.nfl.com/players/tyler-bass/"` |  |
| `players[].jersey_number` | integer or null | `16` |  |
| `players[].position_code` | string or null | `"K"` |  |
| `players[].weight_pounds` | integer or null | `183` |  |
| `players[].years_experience` | integer or null | `7` |  |
| `team_link` | string | `"https://www.nfl.com/teams/buffalo-bills/"` |  |

**Example input**

```json
{
  "team": "Buffalo",
  "unit": "special_teams"
}
```

**Example output**

```json
{
  "team": "Buffalo Bills",
  "players": [
    {
      "age": 29,
      "name": "Tyler Bass",
      "height": "5 ft 10 in",
      "status": "Active",
      "college": "Georgia Southern",
      "position": "Kicker",
      "player_link": "https://www.nfl.com/players/tyler-bass/",
      "jersey_number": 16,
      "position_code": "K",
      "weight_pounds": 183,
      "years_experience": 7
    },
    {
      "age": 32,
      "name": "Reid Ferguson",
      "height": "6 ft 2 in",
      "status": "Active",
      "college": "LSU",
      "position": "Long Snapper",
      "player_link": "https://www.nfl.com/players/reid-ferguson/",
      "jersey_number": 69,
      "position_code": "LS",
      "weight_pounds": 235,
      "years_experience": 10
    },
    {
      "age": 24,
      "name": "Tommy Doman Jr.",
      "height": "6 ft 4 in",
      "status": "Active",
      "college": "Florida",
      "position": "Punter",
      "player_link": "https://www.nfl.com/players/tommy-doman/",
      "jersey_number": 39,
      "position_code": "P",
      "weight_pounds": 214,
      "years_experience": 0
    }
  ],
  "team_link": "https://www.nfl.com/teams/buffalo-bills/"
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@nfl",
  "visibility": "public",
  "operation": "get_player_stats",
  "version": 1,
  "input": {
    "player": "Josh Allen"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@nfl\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_player_stats\",\n  \"version\": 1,\n  \"input\": {\n    \"player\": \"Josh Allen\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@nfl",
  "visibility": "public",
  "operation": "get_player_stats",
  "version": 1,
  "input": {
    "player": "Josh Allen"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@nfl","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Review game scores and kickoff times for a week.
- Compare team records, points, and division ranks.
- Check a team's roster by unit.
- Track a player's season and career stats.

## FAQ

### Is Fous affiliated with NFL?

No. Fous is not affiliated with NFL. This workflow reads the public nfl.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a NFL account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from nfl.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 28, 2026.

### What are the scores and kickoff times for a week?

Get scores returns scores and scheduled games for the NFL week containing a date, optionally filtered by team and time zone.

### Which teams lead their divisions?

Get standings returns regular-season standings by conference and division, including division rank.

### What stats does a player have for a season?

Get player stats returns season and career stats for a named player, using the requested season or the latest season shown.

## Related

- [Yahoo Sports API](https://fous.com/workflows/yahoo-sports.md): Yahoo Sports returns date-based scores and schedules, seasonal standings, and player regular-season and career stats when Yahoo provides them; unavailable data may be missing.
- [NHL API](https://fous.com/workflows/nhl.md): NHL provides games, schedules, and scores when published, standings by date, and player profiles with regular-season stats; dates outside a season have no teams, and unavailable stats are null.
- [ESPN API](https://fous.com/workflows/espn.md): ESPN provides daily scores and schedules, team results, player statistics, matchup summaries, and latest topic-specific headlines; coverage and published details vary, especially for college and soccer.
- [MLB API](https://fous.com/workflows/mlb.md): MLB provides scores, schedules and game details for one date or up to seven days, regular-season division standings defaulting to the current year, and player profiles with regular-season stats for a selected season and career.
- [NBA API](https://fous.com/workflows/nba.md): NBA provides up-to-seven-day schedules and scores, seasonal standings, player bios and available regular-season averages, plus matchup box scores, with undated matchups showing the latest.
- [Premier League API](https://fous.com/workflows/premier-league.md): Premier League provides current/chosen-season tables and recent form, date-range fixtures/results (up to 380), player profiles and stats, and seasonal leaders; older-season stats may be limited.
- [NCAA API](https://fous.com/workflows/ncaa.md): NCAA provides college sports scores and schedules from NCAA.com, including date-based games or football weeks, plus latest NCAA.com Top 25 rankings where published.
- [Sports Reference API](https://fous.com/workflows/sports-reference.md): Sports Reference provides regular-season career stats, awards and season records across basketball, football, baseball and hockey, plus season leaders using the latest published season if unspecified.
- [All Sports workflows](https://fous.com/workflows/category/sports)