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):

{
  "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 · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Use cases
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing
• FAQ and troubleshooting
• More scrapers at scrapers.lat

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.

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

Scores for a week of the regular season:

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

A team roster:

{
  "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:

{
  "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:

{
  "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:

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:

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

Fetch results

Download the dataset items in JSON, CSV or Excel:

$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.