NFL APInfl.com ↗
Access NFL schedules, scores, player stats, rosters, standings, injury reports, fantasy rankings, and news from nfl.com via a single REST API.
What is the NFL API?
The nfl.com API covers 10 endpoints that return game schedules, scores, player statistics, team rosters, standings, injury reports, fantasy rankings, and news directly from nfl.com. The get_game_details endpoint alone returns drive charts, play-by-play, quarter-by-quarter scores, and scoring summaries for any regular season, preseason, or postseason week. All endpoints accept season and week parameters, making it straightforward to query historical or current data.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6305bd0d-6e22-47aa-80cb-ce184496e63e/get_current_week' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nfl-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.nfl_com_api import NFL, SeasonType, StatsCategory, FantasyPosition
nfl = NFL()
# Get current NFL week info
week = nfl.weeks.current()
print(week.season, week.week, week.seasonType, week.dateBegin)
# List all teams for the 2024 season
for team in nfl.teams.list(season="2024"):
print(team.fullName, team.abbreviation, team.conferenceAbbr)
# Get games for a specific week
for game in nfl.games.list(season="2024", season_type=SeasonType.REG, week="1"):
print(game.id, game.date, game.status)
# Get detailed game info with drive charts and play-by-play
for game in nfl.games.list_details(season="2024", season_type=SeasonType.REG, week="1"):
print(game.id, game.date, game.season)
# Get player passing stats
for stat in nfl.playerstats.list(season="2024", category=StatsCategory.PASSING, season_type=SeasonType.REG):
print(stat.player, stat.category)
# Get fantasy QB rankings
for ranking in nfl.fantasyrankings.list(position=FantasyPosition.QB, week="1", season="2024"):
print(ranking.rank, ranking.player_name, ranking.opponent)
# Get latest news
for article in nfl.newsarticles.list():
print(article.title, article.link)
# Get team roster
for player in nfl.rosterplayers.list(team="detroit-lions"):
print(player.player, player.pos, player.college)
Get current NFL week information based on the current date. Returns the season, week number, season type, week type, and date range for the current NFL week. During off-season periods the returned week may span a long date range.
No input parameters required.
{
"type": "object",
"fields": {
"week": "integer, current week number",
"season": "integer, NFL season year",
"dateEnd": "string, end date of the week (YYYY-MM-DD)",
"byeTeams": "array of team abbreviations on bye week",
"weekType": "string, week type (REG, SB, WC)",
"dateBegin": "string, start date of the week (YYYY-MM-DD)",
"seasonType": "string, season type (REG, POST, PRE)"
},
"sample": {
"data": {
"week": 1,
"season": 2026,
"dateEnd": "2026-09-16",
"byeTeams": [],
"weekType": "REG",
"dateBegin": "2026-05-13",
"seasonType": "REG"
},
"status": "success"
}
}About the NFL API
Schedule and Game Data
The get_games endpoint returns game objects with homeTeam, awayTeam, date, time, venue, broadcastInfo, and live status and detail (scores). It accepts season, week, and season_type (REG, POST, PRE) as optional filters, and the response includes pagination fields (limit, token) for iterating across large result sets. For deeper analysis, get_game_details adds driveChart (individual drives and constituent plays), scoringSummaries, and replays to each game object.
Team and Player Data
get_teams returns all 32 franchises with fields like abbreviation, fullName, conferenceAbbr, divisionFullName, primaryColor, and venues. For roster detail, get_team_roster accepts a lowercase-hyphenated team slug (e.g. kansas-city-chiefs) and returns every player's no (jersey number), pos, status, height, weight, experience, and college. Player-level statistics are available through get_player_stats, which supports categories including passing, rushing, receiving, fumbles, tackles, interceptions, field-goals, kickoffs, and kickoff-returns; the endpoint returns full-season aggregates for the chosen season and season_type.
Standings, Injuries, and Fantasy
get_standings returns win/loss records, conference and division placement, streak data, and playoff clinch status, optionally scoped to a single week. get_injuries returns league-wide or team-filtered injury reports with each player's injury, practice_status, and game_status fields. get_fantasy_rankings draws from fantasy.nfl.com and returns ranked players by position (QB, RB, WR, TE, K, DEF) with rank, player_name, player_info, and opponent for a given week and season.
News and Calendar
get_news returns the latest articles from nfl.com with title, link, and summary fields — no parameters required. get_current_week identifies the active NFL week, returning week, season, seasonType, weekType, dateBegin, dateEnd, and a byeTeams array, making it a useful anchor call before querying week-specific endpoints.
The NFL API is a managed, monitored endpoint for nfl.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nfl.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nfl.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a live NFL scoreboard by polling
get_gamesandget_game_detailsfor current-week scores and drive charts. - Power a fantasy football assistant with
get_fantasy_rankingspositional data andget_injuriespractice and game status fields. - Track playoff picture changes week-over-week using
get_standingswith sequentialweekparameters. - Display team depth charts and roster pages using
get_team_rosterplayer objects including position, experience, and college. - Aggregate full-season passing and rushing leaderboards from
get_player_statsacross multiple seasons. - Send injury alert notifications by monitoring changes in
practice_statusandgame_statusfields fromget_injuries. - Surface the latest NFL analysis in a news feed using
get_newstitles, summaries, and article links.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does nfl.com have an official developer API?+
What does `get_player_stats` return and are weekly splits available?+
season and season_type. Weekly per-game stat splits are not currently available. The API covers season-level totals; you can fork it on Parse and revise to add a weekly stats endpoint if that granularity is needed.How does pagination work in `get_games` and `get_standings`?+
pagination object containing a limit field and a token field. Pass the token from a previous response as a query parameter on your next request to retrieve the following page of results.Are historical seasons supported, or only the current year?+
season parameter (such as get_games, get_standings, and get_player_stats) accept prior season years, not just the current one. How far back the data extends depends on what nfl.com retains; very early seasons may return incomplete results.Does the API return individual play-by-play data or only drive summaries?+
get_game_details includes a driveChart object that contains drives and their constituent plays. Standalone play-by-play endpoints with granular fields like yards-after-catch or route data are not currently available. You can fork the API on Parse and revise it to expose additional play-level detail if that structure is needed.