nfl.com APInfl.com ↗
Access NFL schedules, scores, player stats, rosters, standings, injury reports, fantasy rankings, and news from nfl.com via a single REST API.
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'
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.
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 teams on bye week",
"weekType": "string, week type (e.g. REG, SB, WC)",
"dateBegin": "string, start date of the week (YYYY-MM-DD)",
"seasonType": "string, season type (e.g. REG, POST)"
},
"sample": {
"data": {
"week": 4,
"season": 2025,
"dateEnd": "2026-07-29",
"byeTeams": [],
"weekType": "SB",
"dateBegin": "2026-01-28",
"seasonType": "POST"
},
"status": "success"
}
}About the nfl.com 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.
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.
- 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 | 250 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.