NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

NFL API

An American football API for the NFL: get the schedule by week, live scores with the quarter and game clock on paid plans, final scores by quarter, standings with playoff seeds, and every team's roster, from the preseason through the Super Bowl. The free plan covers the current season's schedule, final scores, standings and rosters.

The NFL is served by the American Football API (league=nfl is the default, so no league parameter is needed). The same API key works for every sports API.

NFL data at a glance

Season valueseason=2026 is the 2026 season, including the playoffs and Super Bowl played in early 2027
WeeksEvery game has its week; filter by season_type for preseason, regular season or postseason
Game daydate is the US Eastern date, so Sunday and Monday night games keep their US date
ScoringPoints by quarter in period_scores, plus overtime; ties have winner: null
Neutral sitesInternational games and the Super Bowl have neutral_site: true and their own venue
RostersActive roster, injured reserve and similar lists, and the practice squad, with college and experience
Former teamsThe Oakland Raiders, San Diego Chargers and St. Louis Rams appear in past seasons with their own team ids; Washington's games show the name it had that season

NFL standings fields

wins, losses, ties, win_pct, games_behind (division leader), points_for, points_against, streak, home, road, division and conference records, and the playoff seed in conference_rank.

4 endpoints

https://api.api-ninjas.com/v1/americanfootballgames

Returns schedules, live scores and final scores. Ask for one day, a team's season or one game; with no parameters you get today's NFL games. Paid plans see games in progress with the score, period and clock updated throughout the game; the free plan sees their status and the final score once they end. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.

Full parameter and response reference: /v1/americanfootballgames.

Live Demo

Live demo · no API key required
Query parameters
league
date
team
season
season_type
status
game_id
limit
offset

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/americanfootballgames
Sample response
[
{
"game_id": "nfl-20261019-was-sf",
"league": "nfl",
"sport": "american_football",
"season": 2026,
"season_label": "2026",
"season_type": "regular",
"week": 6,
"date": "2026-10-19",
"start_time": "2026-10-20T00:15:00Z",
"status": "final",
"status_detail": null,
"period": 4,
"clock": null,
"home_team": {
"team_id": "nfl-sf",
"name": "San Francisco 49ers",
"abbreviation": "SF"
},
"away_team": {
"team_id": "nfl-was",
"name": "Washington Commanders",
"abbreviation": "WAS"
},
"home_score": 23,
"away_score": 17,
"period_scores": {
"home": [
13,
7,
3,
0
],
"away": [
3,
0,
7,
7
]
},
"decided_in": "regulation",
"winner": "nfl-sf",
"venue": {
"name": "Levi's Stadium",
"city": "Santa Clara",
"state": "CA",
"country": "US"
},
"neutral_site": false,
"original_date": null,
"updated_at": "2026-10-23T03:13:56Z"
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/americanfootballgames" \ -H "X-Api-Key: YOUR_API_KEY"

https://api.api-ninjas.com/v1/americanfootballstandings

Returns the league table for a season, ordered by league rank, or by conference or division rank when you filter; college tables come conference by conference. For college, poll returns a weekly poll instead: the AP Top 25 or the Coaches Poll, plus the College Football Playoff rankings and the FCS Coaches Poll in football. Tables update throughout the season, shortly after each game ends. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.

Full parameter and response reference: /v1/americanfootballstandings.

Live Demo

Live demo · no API key required
Query parameters
league
season
conference
division
subdivision
poll
week

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/americanfootballstandings
Sample response
[
{
"league": "nfl",
"sport": "american_football",
"season": 2026,
"season_label": "2026",
"team": {
"team_id": "nfl-min",
"name": "Minnesota Vikings",
"abbreviation": "MIN"
},
"conference": "NFC",
"division": "NFC North",
"games_played": 6,
"wins": 6,
"losses": 0,
"ties": 0,
"win_pct": 1,
"games_behind": 0,
"points_for": 125,
"points_against": 74,
"point_differential": 51,
"streak": "W6",
"home_record": "3-0",
"away_record": "3-0",
"division_record": "2-0",
"conference_record": "4-0",
"league_rank": 1,
"conference_rank": 1,
"division_rank": 1,
"final": false
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/americanfootballstandings" \ -H "X-Api-Key: YOUR_API_KEY"

https://api.api-ninjas.com/v1/americanfootballteams

Lists teams with their league, conference, division and home venue. Available on every plan.

Full parameter and response reference: /v1/americanfootballteams.

Live Demo

Live demo · no API key required
Query parameters
league
team
conference
division
subdivision
active

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/americanfootballteams
Sample response
[
{
"team_id": "nfl-kc",
"league": "nfl",
"sport": "american_football",
"abbreviation": "KC",
"name": "Kansas City Chiefs",
"nickname": "Chiefs",
"city": "Kansas City",
"conference": "AFC",
"division": "AFC West",
"venue": {
"name": "Arrowhead Stadium",
"city": "Kansas City",
"state": "MO",
"country": "US"
},
"active": true
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/americanfootballteams" \ -H "X-Api-Key: YOUR_API_KEY"

https://api.api-ninjas.com/v1/americanfootballplayers

Returns current rosters and player profiles, by team or by name. Rosters refresh every day. Available on every plan.

Full parameter and response reference: /v1/americanfootballplayers.

Live Demo

Live demo · no API key required
Query parameters
league
team
name
player_id
position
limit
offset

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/americanfootballplayers?team=KC
Sample response
[
{
"player_id": "nfl-p-c12c062031",
"league": "nfl",
"team": {
"team_id": "nfl-kc",
"name": "Kansas City Chiefs",
"abbreviation": "KC"
},
"name": "Patrick Mahomes",
"first_name": "Patrick",
"last_name": "Mahomes",
"position": "QB",
"jersey_number": "15",
"height_in": 74,
"height_cm": 188,
"weight_lb": 225,
"weight_kg": 102,
"birth_date": "1995-09-17",
"birth_place": {
"city": "Whitehouse",
"state": "TX",
"country": "US"
},
"roster_status": "active",
"college": "Texas Tech",
"experience_years": 10
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/americanfootballplayers?team=KC" \ -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the NFL API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The NFL does not publish a documented public API for developers. The API Ninjas American Football API provides NFL schedules, live and final scores, standings and rosters with league=nfl. API Ninjas is not affiliated with or endorsed by the NFL.
  • Call /v1/americanfootballgames?date=YYYY-MM-DD for one game day, or /v1/americanfootballgames?season=2026 for the season (50 games per page; use offset for more) and filter by the week field. Each game has its week, its US Eastern date and its UTC start time.
  • The season they conclude, named by the year it starts: season=2026 includes the playoff games and the Super Bowl played in January and February 2027, with season_type=postseason.
  • A tied final game has equal scores and winner: null. Standings include ties for every team.

API Ninjas is not affiliated with or endorsed by the NFL, the NBA, the NHL, the NCAA or any other league, conference, competition, school or team. League, competition and team names are trademarks of their owners and are used only to identify them.