# NFL Scores, Standings, Teams & Rosters Scraper (`scrapers_lat/nfl-scores-standings-scraper`) Actor

Scrape NFL game scores by week or date, conference and division standings, all 32 teams and full rosters. Get matchups, scores, records, ties, streaks, seeds, odds, box scores and player bios. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/nfl-scores-standings-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Sports, Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.56 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![NFL Scores, Standings, Teams & Rosters Scraper](https://scrapers.lat/banners/nfl-scores-standings-scraper.png)](https://console.apify.com/actors/exQjkKifzGjiykjKz/input)

## NFL Scores, Standings, Teams & Rosters Scraper

Here is one real result, with every field the actor returns (a completed game with the box score and AI matchup add-ons switched on):

```json
{
  "recordType": "game",
  "gameId": "401772830",
  "season": "2025",
  "seasonYear": 2025,
  "seasonType": "Regular Season",
  "week": 1,
  "date": "2025-09-07T17:00Z",
  "name": "Tampa Bay Buccaneers at Atlanta Falcons",
  "shortName": "TB @ ATL",
  "state": "post",
  "status": "Final",
  "statusDetail": "Final",
  "completed": true,
  "period": 4,
  "clock": "0:00",
  "homeTeam": "Atlanta Falcons",
  "homeAbbrev": "ATL",
  "homeTeamId": "1",
  "homeScore": 20,
  "homeWinner": false,
  "homeRecord": "0-1",
  "homeLogo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/atl.png",
  "awayTeam": "Tampa Bay Buccaneers",
  "awayAbbrev": "TB",
  "awayTeamId": "27",
  "awayScore": 23,
  "awayWinner": true,
  "awayRecord": "1-0",
  "awayLogo": "https://a.espncdn.com/i/teamlogos/nfl/500/scoreboard/tb.png",
  "venue": "Mercedes-Benz Stadium",
  "venueCity": "Atlanta",
  "venueState": "GA",
  "attendance": 71610,
  "broadcast": "FOX",
  "url": "https://www.espn.com/nfl/game/_/gameId/401772830/buccaneers-falcons",
  "homeFirstDowns": 23,
  "homeThirdDownEff": "6-15",
  "homeTotalYards": 358,
  "homePassingYards": 289,
  "homeCompAtt": "27/42",
  "homeRushingYards": 69,
  "homePossession": "35:12",
  "awayFirstDowns": 16,
  "awayTotalYards": 260,
  "awayPassingYards": 159,
  "awayRushingYards": 101,
  "awayPossession": "24:48",
  "homeGamePassingLeader": "Michael Penix Jr.",
  "homeGamePassingLine": "27/42, 298 YDS, 1 TD",
  "homeGameRushingLeader": "Tyler Allgeier",
  "homeGameReceivingLeader": "Bijan Robinson",
  "homeGameReceivingLine": "6 REC, 100 YDS, 1 TD",
  "awayGamePassingLeader": "Baker Mayfield",
  "awayGamePassingLine": "17/32, 167 YDS, 3 TD",
  "awayGameReceivingLeader": "Emeka Egbuka",
  "aiStoryline": "In a tightly contested season opener, the Tampa Bay Buccaneers edged out the Atlanta Falcons with a late field goal, showcasing their resilience and strategic play.",
  "aiKeyPlayers": "Baker Mayfield, Chris Godwin, Younghoe Koo",
  "aiPrediction": "The Buccaneers' strong start sets a positive tone for their season, while the Falcons will need to regroup quickly to avoid falling behind in the division.",
  "observedAt": "2026-08-21T05:19:12.924Z",
  "error": null
}
```

The most complete NFL scraper available. It returns every field the public NFL data feed exposes for scores, standings, teams and rosters, plus derived fields such as per-team passing, rushing and receiving leaders, home and away box score splits, and an optional AI matchup summary, and gives you four modes with week, date and team filters to target exactly the records you need.

**📥 [Input](https://apify.com/scrapers_lat/nfl-scores-standings-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/nfl-scores-standings-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/nfl-scores-standings-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/nfl-scores-standings-scraper/examples)**

![Platform](https://img.shields.io/badge/platform-Apify-blue) ![Coverage](https://img.shields.io/badge/coverage-NFL%2032%20teams-orange) ![Output](https://img.shields.io/badge/output-JSON%20%7C%20CSV%20%7C%20Excel-green) ![Billing](https://img.shields.io/badge/billing-pay%20per%20result-purple)

### Table of contents

- [What it does](#what-it-does)
- [Use cases](#use-cases)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing](#billing)
- [FAQ and troubleshooting](#faq-and-troubleshooting)
- [More scrapers at scrapers.lat](#more-scrapers-at-scraperslat)

### What it does

This actor pulls live and historical NFL data in four modes:

- **Scores**: one record per game for a week, season type or single date. Matchup, scores, live status and quarter clock, home and away records, venue and attendance, broadcast networks, betting line when posted, and per-team passing, rushing and receiving leaders. Optional per-game team box score and an optional AI matchup summary.
- **Standings**: one record per team with conference, division, playoff seed, wins, losses, ties, win percentage, games behind, current streak, division and conference records, points for and against, point differential, and clinch indicator.
- **Teams**: one record per team (all 32) with location, nickname, colors, logo, home stadium, and current standing summary.
- **Roster**: one record per player for a chosen team with jersey number, position, height, weight, age, birthplace, college, years of experience, salary when available, and headshot.

It is built for NFL fans, fantasy football and betting tools, media sites, and app developers who need clean, structured NFL data without maintaining a scraper.

### Use cases

- **Fantasy football**: pull rosters, player bios and weekly game results to power draft tools, lineup optimizers and waiver-wire alerts.
- **Betting and odds research**: capture point spread, over/under and moneyline when a sportsbook line is posted, plus final scores and box score splits for model backtesting.
- **Sports media and content**: feed live scores, standings and matchup storylines into websites, newsletters, scoreboards and social accounts.
- **Apps and products**: back an NFL app or dashboard with structured scores, standings, teams and rosters exported as JSON, CSV or Excel.
- **Analytics and data science**: build historical datasets of games, team box scores and standings by week and season for trend analysis and modeling.

### Quickstart

Get standings for the current season, or set a mode. Free Apify plans return up to 10 records per run.

```json
{
  "mode": "standings",
  "maxResults": 32
}
```

Scores for a week of the regular season:

```json
{
  "mode": "scores",
  "season": 2025,
  "week": 1,
  "seasonType": "reg",
  "maxResults": 20
}
```

A team roster:

```json
{
  "mode": "roster",
  "teamAbbrev": "KC",
  "maxResults": 60
}
```

### Input reference

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `mode` | string | no | What to scrape: `scores`, `standings`, `teams` or `roster`. Default `standings`. | `"scores"` |
| `season` | integer | no | Scores mode. NFL season year, for example 2025 for the 2025 season. Combine with `week` and `seasonType`. | `2025` |
| `week` | integer | no | Scores mode. Week number within the season type (1 to 18 for the regular season). | `1` |
| `seasonType` | string | no | Scores mode. Part of the season: `pre`, `reg` or `post`. | `"reg"` |
| `date` | string | no | Scores mode only. A single day in YYYY-MM-DD. Overrides season and week. | `"2025-09-07"` |
| `teamAbbrev` | string | no | Roster mode. Team abbreviation such as KC, PHI, DAL, BUF, SF. | `"KC"` |
| `teamId` | string | no | Roster mode. Numeric team id (alternative to `teamAbbrev`; wins if both set). | `"12"` |
| `includeBoxScore` | boolean | no | Scores mode, paid plans. Add the full team box score per game. Billed only when a real box score is returned. | `true` |
| `aiMatchupSummary` | boolean | no | Scores mode, paid plans. Add an AI storyline, key players and prediction per game. Billed only on usable AI output. | `true` |
| `maxResults` | integer | no | Maximum records to return. Free plans are capped at 10. | `20` |

### Output reference

Field set depends on `mode`. Common and per-mode fields:

| Name | Type | Description |
| --- | --- | --- |
| `recordType` | string | `game`, `standing`, `team` or `player` |
| `gameId` | string | Game id (scores) |
| `season` / `seasonYear` / `seasonType` / `week` | string, number | Season context (scores) |
| `date` | string | Game date and time, ISO 8601 (scores) |
| `shortName` | string | Short matchup, e.g. TB @ ATL (scores) |
| `statusDetail` | string | Game status, e.g. Final or 3rd 4:12 (scores) |
| `homeTeam` / `awayTeam` | string | Team names (scores) |
| `homeScore` / `awayScore` | number | Team scores (scores) |
| `homeWinner` / `awayWinner` | boolean | Which team won (scores) |
| `homeRecord` / `awayRecord` | string | Season record at game time (scores) |
| `homePassingLeader` / `homeRushingLeader` / `homeReceivingLeader` | string | Per-team category leaders (scores) |
| `homeTopPerformer` / `homeTopPerformerLine` | string | Standout player and stat line per team (scores) |
| `venue` / `venueCity` / `venueState` / `attendance` | string, number | Stadium, location and attendance (scores, teams) |
| `broadcast` | string | Broadcast networks (scores) |
| `spread` / `overUnder` / `homeMoneyLine` / `awayMoneyLine` / `oddsDetails` | number, string | Betting line when posted (scores) |
| `homeFirstDowns` / `homeTotalYards` / `homePassingYards` / `homeRushingYards` / `homePossession` | number, string | Team box score, box score add-on (scores) |
| `homeThirdDownEff` / `homeRedZone` / `homeTurnovers` / `homeSacks` / `homePenalties` | string, number | Team box score detail, box score add-on (scores) |
| `homeGamePassingLeader` / `homeGamePassingLine` | string | Box score passing/rushing/receiving leaders, add-on (scores) |
| `aiStoryline` / `aiKeyPlayers` / `aiPrediction` | string | AI matchup summary, AI add-on (scores) |
| `team` / `teamAbbrev` / `teamId` | string | Team identity (standings, teams, roster) |
| `conference` / `division` | string | Conference (AFC/NFC) and division (standings, teams) |
| `playoffSeed` / `wins` / `losses` / `ties` / `winPct` | number | Standing (standings) |
| `gamesBehind` / `streak` / `record` / `clinchIndicator` | string | Games behind, streak, overall record, clinch (standings) |
| `divisionRecord` / `conferenceRecord` | string | Split records (standings) |
| `pointsFor` / `pointsAgainst` / `pointDifferential` | number | Scoring totals (standings) |
| `location` / `nickname` / `color` / `alternateColor` / `teamLogo` | string | Team identity and branding (teams) |
| `standingSummary` | string | e.g. 1st in AFC East (teams) |
| `player` / `jersey` / `position` / `positionAbbrev` / `positionGroup` | string | Player identity (roster) |
| `height` / `weight` / `age` / `college` / `experienceYears` / `salary` | string, number | Player bio (roster) |
| `birthCity` / `birthState` / `birthCountry` / `dateOfBirth` / `headshot` | string | Player origin and photo (roster) |
| `observedAt` | string | When the record was captured, ISO 8601 |
| `error` | string | Error message when a record could not be built, otherwise null |

### Example output record

A standings record:

```json
{
  "recordType": "standing",
  "team": "Buffalo Bills",
  "teamAbbrev": "BUF",
  "teamId": "2",
  "conference": "American Football Conference",
  "division": "AFC East",
  "playoffSeed": 1,
  "wins": 1,
  "losses": 0,
  "ties": 0,
  "winPct": 1,
  "gamesBehind": "-",
  "streak": "W1",
  "record": "1-0",
  "homeRecord": "1-0",
  "awayRecord": "0-0",
  "divisionRecord": "0-0",
  "conferenceRecord": "0-0",
  "pointsFor": 29,
  "pointsAgainst": 14,
  "pointDifferential": 15,
  "clinchIndicator": null,
  "teamLogo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png",
  "observedAt": "2026-08-21T05:18:58.135Z",
  "error": null
}
```

A roster record:

```json
{
  "recordType": "player",
  "player": "Patrick Mahomes",
  "team": "Kansas City Chiefs",
  "teamAbbrev": "KC",
  "teamId": "12",
  "jersey": "15",
  "position": "Quarterback",
  "positionAbbrev": "QB",
  "positionGroup": "offense",
  "height": "6' 2\"",
  "weight": "225 lbs",
  "age": 30,
  "dateOfBirth": "1995-09-17",
  "birthCity": "Whitehouse",
  "birthState": "TX",
  "birthCountry": "USA",
  "college": "Texas Tech",
  "experienceYears": 10,
  "salary": 10551152,
  "jerseyStatus": "Active",
  "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3139477.png",
  "playerId": "3139477",
  "observedAt": "2026-08-21T05:19:30.954Z",
  "error": null
}
```

### Run via API and CLI

Start a run with the Apify API:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nfl-scores-standings-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"scores","season":2025,"week":1,"seasonType":"reg","maxResults":20}'
```

Run with the Apify CLI:

```bash
apify call scrapers_lat/nfl-scores-standings-scraper \
  --input '{"mode":"standings","maxResults":32}'
```

### Fetch results

Download the dataset items in JSON, CSV or Excel:

```bash
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=csv" -o nfl.csv
```

The run response includes `defaultDatasetId`. Add `&format=json`, `&format=csv` or `&format=xlsx`.

### Billing

This actor is pay per result. You are charged per record returned. Empty runs (for example a week with no games) return nothing and are not charged for results. All prices are per event, and add-ons are billed only when they produce real content.

| Event | Price (USD) | When it is charged |
| --- | --- | --- |
| `apify-actor-start` | 0.008 | Once per run, when the run starts. |
| `result` | 0.008 | Per record returned: one game (scores), one team standing (standings), one team (teams), or one player (roster). |
| `game_boxscore` | 0.008 | Scores mode add-on, opt-in. Per game, only when a real team box score is returned. |
| `ai_matchup_summary` | 0.012 | Scores mode add-on, opt-in. Per game, only when usable AI output is produced. |

- **No charge on failure.** A record is only billed when real data is produced. Box score and AI events are billed only when they actually return content.
- **Free plan cap.** Free Apify accounts return up to 10 records per run and cannot use the paid add-ons. Paid accounts can raise `maxResults`.
- **Spend cap.** The actor respects your run `maxTotalChargeUsd` and stops emitting billable records once the limit is reached.

Prices shown are the FREE-tier rate; volume tiers (Bronze through Diamond) are slightly lower.

### FAQ and troubleshooting

**No records came back for my week.** That week or date had no scheduled games. Try a week during the season, or a valid `season` plus `seasonType`.

**Which team abbreviations work?** Standard NFL abbreviations such as KC, PHI, DAL, BUF, SF, GB. You can also pass a numeric `teamId`.

**Are salaries always present?** Salary is included when the source exposes it; otherwise it is null.

**Is betting data always included?** The spread, over/under and moneyline are included when a sportsbook line is posted for a game, otherwise they are null.

**How fresh is the data?** Scores reflect live game state including the current quarter and clock. Standings and rosters reflect the current season.

### More scrapers at scrapers.lat

Building sports and data products? Explore more actors from scrapers\_lat on Apify for scores, standings, odds and structured public data across sports, finance and business.

***

This actor is an independent tool that collects publicly available information. It is not affiliated with, endorsed by, or sponsored by the NFL or any team or data provider.

# Actor input Schema

## `mode` (type: `string`):

Choose the kind of NFL data to collect: game scores for a week or date, the league standings, the list of teams, or a team's roster.

## `season` (type: `integer`):

Scores mode. NFL season year (for example 2025 for the 2025 season). Combine with Week and Season type to select a slate. Standings and teams reflect the current season by default.

## `week` (type: `integer`):

Scores mode. Week number within the chosen season type (1 to 18 for the regular season). Combine with Season and Season type.

## `seasonType` (type: `string`):

Scores mode. Which part of the season to pull: preseason, regular season or postseason.

## `date` (type: `string`):

Scores mode only. A single day in YYYY-MM-DD format (for example 2025-09-07). Overrides Season/Week. Leave empty to use Season + Week, or return the current slate.

## `teamAbbrev` (type: `string`):

Roster mode only. Team abbreviation such as KC, PHI, DAL, BUF, SF. Used to select which team's players to return.

## `teamId` (type: `string`):

Roster mode only. Numeric team ID (alternative to Team abbreviation). If both are set, Team ID wins.

## `includeBoxScore` (type: `boolean`):

Scores mode only, paid plans only. Fetch the full team box score for each game (total yards, passing, rushing, first downs, third-down efficiency, turnovers, possession) plus per-side passing/rushing/receiving leaders. Billed per game only when a real box score is returned.

## `aiMatchupSummary` (type: `boolean`):

Scores mode only, paid plans only. Add an AI-written storyline, key players and prediction for each game. Billed per game only when usable AI output is produced.

## `maxResults` (type: `integer`):

Maximum number of records to collect (games, standings rows, teams or players). Free Apify plans are capped at 10 per run.

## Actor input object example

```json
{
  "mode": "standings",
  "teamAbbrev": "KC",
  "includeBoxScore": false,
  "aiMatchupSummary": false,
  "maxResults": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "standings",
    "teamAbbrev": "KC",
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/nfl-scores-standings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "standings",
    "teamAbbrev": "KC",
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/nfl-scores-standings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "standings",
  "teamAbbrev": "KC",
  "maxResults": 10
}' |
apify call scrapers_lat/nfl-scores-standings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/nfl-scores-standings-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/exQjkKifzGjiykjKz/builds/47IMUQdiEtmNKPjUQ/openapi.json