NFL & NCAA API Documentation — 17 Endpoints

  
 NFL & NCAA API Documentation
 v1.4.7 17 endpoints 
 https://v1.american-football.sportsdataapi.com 
 
Start Free Trial
 Back to NFL & NCAA API 

Endpoints  Timezone (1)  Seasons (1)  Leagues (1)  Teams (1)  Players (2)  Injuries (1)  Games (4)  Standings (3)  Odds (3)  
 Timezone 1 endpoint 
  GET /timezone timezone  Returns the list of timezone set that can be used in the endpoint games.

Parameters: This endpoint does not require any parameters.
 GET https://v1.american-football.sportsdataapi.com/timezone 
This endpoint does not require any query parameters.
 
 Seasons 1 endpoint 
  GET /seasons seasons  Return the list of all available seasons for all competitions.

All seasons are only 4-digit keys, so for a league whose season is 2018-2019 the season in the API will be 2018.

All seasons can be used in other endpoints as filters.

Parameters: This endpoint does not require any parameters.
 GET https://v1.american-football.sportsdataapi.com/seasons 
This endpoint does not require any query parameters.
 
 Leagues 1 endpoint 
  GET /leagues leagues  Return the list of all available competitions.

The league id are unique in the API and competitions keep it across all seasons

This endpoint contains a field named coverage that indicates for each season of a competition the data that are available.
 GET https://v1.american-football.sportsdataapi.com/leagues 
Query Parameters   Name Type Required Description 
  id integer     The id of the league   
 season integer     The season of the league   
 current string     truefalse 
 
  
 
 Teams 1 endpoint 
  GET /teams teams  Return a set of data about the teams.

The team id are unique in the API and teams keep it among all the competitions in which they participate.

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every day
 GET https://v1.american-football.sportsdataapi.com/teams 
Query Parameters   Name Type Required Description 
  id integer     The id of the team   
 league integer     A valid League id   
 season integer     A valid season   
 name string     The name of the team   
 code string     The code of the team   
 search string     The name of the team   
  
 
 Players 2 endpoints 
  GET /players players  Return a set of data about the players.

The players id are unique in the API and  keep it among all the competitions in which they participate.

*Not all data is available for all players.*

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every day
 GET https://v1.american-football.sportsdataapi.com/players 
Query Parameters   Name Type Required Description 
  id integer     The id of the player   
 name string     The name of the player   
 team integer     The id of the team   
 season integer     The season   
 search string     The name of the player   
  
 GET /players/statistics statistics  Return the statistics of a player for the whole season.

The statistics of the players are different depending on the positions they occupy in the formation, so they are grouped into different groups.

Available Groups
  * Defense
  * Kicking
  * Passing
  * Punting
  * Receiving
  * Returning
  * Rushing
  * Scoring

Data for this endpoint start from 2022 season

Parameters: This endpoint requires at least two parameters id or team and season.

This endpoint is updated every day
 GET https://v1.american-football.sportsdataapi.com/players/statistics 
Query Parameters   Name Type Required Description 
  id integer     The id of the player   
 team integer     The id of the team   
 season integer     The season   
  
 
 Injuries 1 endpoint 
  GET /injuries injuries  Return the list of injured players.

There is no preserved history, only the currently injured players appear in this endpoint.

Parameters: This endpoint requires at least one parameter id or team.

This endpoint is updated every hour
 GET https://v1.american-football.sportsdataapi.com/injuries 
Query Parameters   Name Type Required Description 
  player integer     The id of the player   
 team integer     The id of the team   
  
 
 Games 4 endpoints 
  GET /games games  Return the list of games according to the given parameters.

For all requests to games you can add the query parameter timezone to your request in order to retrieve the list of games in the time zone of your choice like *“Europe/London“*. In case the timezone is not recognized, empty or is not part of the endpoint timezone list, the UTC value will be applied by default

To know the list of available timezones you have to use the endpoint timezone.

Available Status

* NS : Not Started
* Q1 : First Quarter (In Play)
* Q2 : Second Quarter (In Play)
* Q3 : Third Quarter (In Play)
* Q4 : Fourth Quarter (In Play)
* OT : Overtime (In Play)
* HT : Halftime (In Play)
* FT : Finished (Game Finished)
* AOT : After Over Time (Game Finished)
* CANC : Cancelled (Game cancelled and not rescheduled)
* PST : Postponed (Game postponed and waiting for a new game date)

Parameters: This endpoint requires at least one of these parameters id, date, league, team, live, h2h.

Games are updated every 30 seconds
 GET https://v1.american-football.sportsdataapi.com/games 
Query Parameters   Name Type Required Description 
  id integer     The id of the game   
 date string     A valid date   
 league integer     The id of the league   
 season integer     The season of the league   
 team integer     The id of the team   
 h2h string     Two teams Ids   
 live string     all 
 
 timezone string     A valid timezone   
  
 GET /games/events events  Return the list of events for one game id.

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every 30 seconds
 GET https://v1.american-football.sportsdataapi.com/games/events 
Query Parameters   Name Type Required Description 
  id integer     The id of the game   
  
 GET /games/statistics/teams teams statistics  Return team statistics from a game id.

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every 30 seconds
 GET https://v1.american-football.sportsdataapi.com/games/statistics/teams 
Query Parameters   Name Type Required Description 
  id integer     The id of the game   
 team integer     The id of the team   
  
 GET /games/statistics/players players statistics  Return players statistics from a game id.

The statistics of the players are different depending on the positions they occupy in the formation, so they are grouped into different groups.

Available Groups
  * defensive
  * fumbles
  * interceptions
  * kick_returns
  * kicking
  * passing
  * punt_returns
  * punting
  * receiving
  * rushing

Parameters: This endpoint requires at least one parameter.

This endpoint is updated every 30 seconds
 GET https://v1.american-football.sportsdataapi.com/games/statistics/players 
Query Parameters   Name Type Required Description 
  id integer     The id of the game   
 group string     A valid group  defensivefumblesinterceptionskick_returnskickingpassingpunt_returnspuntingreceivingrushing 
 
 team integer     The id of the team   
 player integer     The id of the player   
  
 
 Standings 3 endpoints 
  GET /standings standings  Return the standings of a competition in relation to a given season.

To know the list of available conferences or divisions you have to use the endpoint standings/conferences or standings/divisions.

Parameters: This endpoint requires at least two parameters league and season.

This endpoint is updated every hour
 GET https://v1.american-football.sportsdataapi.com/standings 
Query Parameters   Name Type Required Description 
  league integer     The id of the league   
 season integer     The season of the league   
 team integer     The id of the team   
 conference string     A valid conference   
 division string     A valid division   
  
 GET /standings/conferences conferences  Return the list of available conferences for a competition to be used in the standings endpoint.

Parameters: This endpoint requires at least two parameters league and season.
 GET https://v1.american-football.sportsdataapi.com/standings/conferences 
Query Parameters   Name Type Required Description 
  league integer     The id of the league   
 season integer     The season of the league   
  
 GET /standings/divisions divisions  Return the list of available divisions for a competition to be used in the standings endpoint.

Parameters: This endpoint requires at least two parameters league and season.
 GET https://v1.american-football.sportsdataapi.com/standings/divisions 
Query Parameters   Name Type Required Description 
  league integer     The id of the league   
 season integer     The season of the league   
  
 
 Odds 3 endpoints 
  GET /odds odds  Return the list of available odds for games.

We provide pre-match odds between 1 and 7 days before the game.

We keep a 7-day history *(The availability of odds may vary according to the games, seasons and bookmakers)*

Parameters: This endpoint requires at least one of theses parameters : game.

Odds are updated four times a day
 GET https://v1.american-football.sportsdataapi.com/odds 
Query Parameters   Name Type Required Description 
  game integer     The id of the game   
 bookmaker integer     The id of the bookmaker   
 bet integer     The id of the bet   
  
 GET /odds/bets bets  Return the list of available bets for odds.

All bets id can be used in endpoint odds as filters

Parameters: You can call this endpoint without any parameters to get the complete list.
 GET https://v1.american-football.sportsdataapi.com/odds/bets 
Query Parameters   Name Type Required Description 
  id integer     The id of the bet   
 search string     The name of the bet   
  
 GET /odds/bookmakers bookmakers  Return the list of available bookmakers for odds.

All bookmakers id can be used in endpoint odds as filters.

Parameters: You can call this endpoint without any parameters to get the complete list.
 GET https://v1.american-football.sportsdataapi.com/odds/bookmakers 
Query Parameters   Name Type Required Description 
  id integer     The id of the bookmaker   
 search string     The name of the bookmaker   
  
 

Name	Type	Description
id	integer	The id of the league
season	integer	The season of the league
current	string	truefalse

Name	Type	Description
id	integer	The id of the team
league	integer	A valid League id
season	integer	A valid season
name	string	The name of the team
code	string	The code of the team
search	string	The name of the team

Name	Type	Description
id	integer	The id of the player
name	string	The name of the player
team	integer	The id of the team
season	integer	The season
search	string	The name of the player

Name	Type	Description
id	integer	The id of the player
team	integer	The id of the team
season	integer	The season

Name	Type	Required	Description
player	integer		The id of the player
team	integer		The id of the team

Name	Type	Description
id	integer	The id of the game
date	string	A valid date
league	integer	The id of the league
season	integer	The season of the league
team	integer	The id of the team
h2h	string	Two teams Ids
live	string	all
timezone	string	A valid timezone

Name	Type	Required	Description
id	integer		The id of the game

Name	Type	Required	Description
id	integer		The id of the game
team	integer		The id of the team

Name	Type	Description
id	integer	The id of the game
group	string	A valid group defensivefumblesinterceptionskick_returnskickingpassingpunt_returnspuntingreceivingrushing
team	integer	The id of the team
player	integer	The id of the player

Name	Type	Description
league	integer	The id of the league
season	integer	The season of the league
team	integer	The id of the team
conference	string	A valid conference
division	string	A valid division

Name	Type	Required	Description
league	integer		The id of the league
season	integer		The season of the league

Name	Type	Required	Description
league	integer		The id of the league
season	integer		The season of the league

Name	Type	Description
game	integer	The id of the game
bookmaker	integer	The id of the bookmaker
bet	integer	The id of the bet

Name	Type	Required	Description
id	integer		The id of the bet
search	string		The name of the bet

Name	Type	Required	Description
id	integer		The id of the bookmaker
search	string		The name of the bookmaker

Quick Reference Base URL https://v1.american-football.sportsdataapi.com 
 Authentication x-apisports-key: YOUR_API_KEY 
 cURL 
curl -X GET "https://v1.american-football.sportsdataapi.com/timezone" \
  -H "x-apisports-key: YOUR_API_KEY"

Start free. Scale when ready.Get 100 free nfl & ncaa API requests per day. No credit card required.
Upgrade to PRO for full real-time data, live odds, and unlimited historical access.
 
Start Free Trial
  View Pricing Plans 