NFL v3 Stats API

by sportsdata.io

Overview

NFL rosters, player stats, team stats, and fantasy stats API.

NFL v3 Stats is an entertainment API from sportsdata.io. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 76 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Unknown
Category: Entertainment
Base URL: http://azure-api.sportsdata.io/v3/nfl/stats
Version: 1.0
Endpoints: 76
OpenAPI: Specification ↗
Spec updated: 2023-03-05

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "http://azure-api.sportsdata.io/v3/nfl/stats/FORMAT/ActiveBoxScores" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("http://azure-api.sportsdata.io/v3/nfl/stats/FORMAT/ActiveBoxScores", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "http://azure-api.sportsdata.io/v3/nfl/stats/FORMAT/ActiveBoxScores",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/{format}/ActiveBoxScores`	Legacy Box Scores Active
GET	`/{format}/AllTeams`	Teams (All)
GET	`/{format}/AreAnyGamesInProgress`	Are Games In Progress
GET	`/{format}/BoxScore/{season}/{week}/{hometeam}`	Legacy Box Score
GET	`/{format}/BoxScoreByScoreIDV3/{scoreid}`	Box Score by ScoreID V3
GET	`/{format}/BoxScoreV3/{season}/{week}/{hometeam}`	Box Score V3
GET	`/{format}/BoxScores/{season}/{week}`	Legacy Box Scores
GET	`/{format}/BoxScoresDelta/{season}/{week}/{minutes}`	Legacy Box Scores Delta
GET	`/{format}/BoxScoresDeltaV3/{season}/{week}/{playerstoinclude}/{minutes}`	Box Scores Delta V3
GET	`/{format}/Byes/{season}`	Bye Weeks
GET	`/{format}/CurrentSeason`	Season Current
GET	`/{format}/CurrentWeek`	Week Current
GET	`/{format}/DailyFantasyPlayers/{date}`	Daily Fantasy Players
GET	`/{format}/DailyFantasyPoints/{date}`	Daily Fantasy Scoring
GET	`/{format}/DfsSlatesByDate/{date}`	DFS Slates by Date
GET	`/{format}/DfsSlatesByWeek/{season}/{week}`	DFS Slates by Week
GET	`/{format}/FantasyDefenseByGame/{season}/{week}`	Fantasy Defense Game Stats
GET	`/{format}/FantasyDefenseByGameByTeam/{season}/{week}/{team}`	Fantasy Defense Game Stats by Team
GET	`/{format}/FantasyDefenseBySeason/{season}`	Fantasy Defense Season Stats
GET	`/{format}/FantasyDefenseBySeasonByTeam/{season}/{team}`	Fantasy Defense Season Stats by Team
GET	`/{format}/FantasyPlayers`	Fantasy Players with ADP
GET	`/{format}/FantasyPlayersIDP`	IDP Fantasy Players with ADP
GET	`/{format}/FinalBoxScores`	Legacy Box Scores Final
GET	`/{format}/FreeAgents`	Player Details by Free Agents
GET	`/{format}/GameLeagueLeaders/{season}/{week}/{position}/{column}`	League Leaders by Week
GET	`/{format}/GameStats/{season}`	Game Stats by Season (Deprecated, use Team Game Stats instead)
GET	`/{format}/GameStatsByWeek/{season}/{week}`	Game Stats by Week (Deprecated, use Team Game Stats instead)
GET	`/{format}/Injuries/{season}/{week}`	Injuries
GET	`/{format}/Injuries/{season}/{week}/{team}`	Injuries by Team
GET	`/{format}/LastCompletedSeason`	Season Last Completed
GET	`/{format}/LastCompletedWeek`	Week Last Completed
GET	`/{format}/LiveBoxScores`	Legacy Box Scores Live
GET	`/{format}/News`	News
GET	`/{format}/NewsByDate/{date}`	News by Date
GET	`/{format}/NewsByPlayerID/{playerid}`	News by Player
GET	`/{format}/NewsByTeam/{team}`	News by Team
GET	`/{format}/Player/{playerid}`	Player Details by Player
GET	`/{format}/PlayerGameRedZoneInsideFiveStats/{season}/{week}`	Player Game Red Zone Stats Inside Five
GET	`/{format}/PlayerGameRedZoneInsideTenStats/{season}/{week}`	Player Game Red Zone Stats Inside Ten
GET	`/{format}/PlayerGameRedZoneStats/{season}/{week}`	Player Game Red Zone Stats
GET	`/{format}/PlayerGameStatsByPlayerID/{season}/{week}/{playerid}`	Player Game Stats by Player
GET	`/{format}/PlayerGameStatsBySeason/{season}/{playerid}/{numberofgames}`	Player Game Logs By Season
GET	`/{format}/PlayerGameStatsByTeam/{season}/{week}/{team}`	Player Game Stats by Team
GET	`/{format}/PlayerGameStatsByWeek/{season}/{week}`	Player Game Stats by Week
GET	`/{format}/PlayerGameStatsByWeekDelta/{season}/{week}/{minutes}`	Player Game Stats by Week Delta
GET	`/{format}/PlayerGameStatsDelta/{minutes}`	Player Game Stats Delta
GET	`/{format}/PlayerOwnership/{season}/{week}`	Fantasy Player Ownership Percentages (Season-Long)
GET	`/{format}/PlayerSeasonRedZoneInsideFiveStats/{season}`	Player Season Red Zone Stats Inside Five
GET	`/{format}/PlayerSeasonRedZoneInsideTenStats/{season}`	Player Season Red Zone Stats Inside Ten
GET	`/{format}/PlayerSeasonRedZoneStats/{season}`	Player Season Red Zone Stats
GET	`/{format}/PlayerSeasonStats/{season}`	Player Season Stats
GET	`/{format}/PlayerSeasonStatsByPlayerID/{season}/{playerid}`	Player Season Stats by Player
GET	`/{format}/PlayerSeasonStatsByTeam/{season}/{team}`	Player Season Stats by Team
GET	`/{format}/PlayerSeasonThirdDownStats/{season}`	Player Season Third Down Stats
GET	`/{format}/Players`	Player Details by Available
GET	`/{format}/Players/{team}`	Player Details by Team
GET	`/{format}/ProBowlers/{season}`	Pro Bowlers
GET	`/{format}/RecentlyUpdatedBoxScores/{minutes}`	Legacy Box Scores Delta (Current Week)
GET	`/{format}/Rookies/{season}`	Player Details by Rookie Draft Year
GET	`/{format}/Schedules/{season}`	Schedule
GET	`/{format}/Scores/{season}`	Scores by Season
GET	`/{format}/ScoresByDate/{date}`	Scores by Date
GET	`/{format}/ScoresByWeek/{season}/{week}`	Scores by Week
GET	`/{format}/SeasonLeagueLeaders/{season}/{position}/{column}`	League Leaders by Season
GET	`/{format}/SimulatedBoxScoresV3/{numberofplays}`	Box Scores V3 Simulation
GET	`/{format}/SimulatedScores/{numberofplays}`	Scores by Week Simulation
GET	`/{format}/Stadiums`	Stadiums
GET	`/{format}/Standings/{season}`	Standings
GET	`/{format}/TeamGameStats/{season}/{week}`	Team Game Stats
GET	`/{format}/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}`	Team Game Logs By Season
GET	`/{format}/TeamSeasonStats/{season}`	Team Season Stats
GET	`/{format}/Teams`	Teams (Active)
GET	`/{format}/Teams/{season}`	Teams by Season
GET	`/{format}/Timeframes/{type}`	Timeframes
GET	`/{format}/UpcomingSeason`	Season Upcoming
GET	`/{format}/UpcomingWeek`	Week Upcoming

Questions

Does the NFL v3 Stats API need an API key?

Yes. The NFL v3 Stats API uses API key authentication; the documentation explains how to get credentials.

Does the NFL v3 Stats API support HTTPS?

Yes, the NFL v3 Stats API is served over HTTPS.

How many endpoints does the NFL v3 Stats API have?

Its OpenAPI description lists 76 endpoints in version 1.0. All of them are shown on this page.

What are alternatives to the NFL v3 Stats API?

Other Entertainment APIs include Techy, Imgflip, Official Joke, Betfair: Exchange Streaming API, Listen API: Podcast Search, Directory, and Insights API.

Compare alternatives →