NFL & NCAAF API / teams

Team statistics

GET https://american-football.highlightly.net/teams/statistics/{id} NFL & NCAAF API
GET https://sports.highlightly.net/american-football/teams/statistics/{id} All Sports API

Retrieve a team's statistics, one entry per leagueName and round, such as regular-season.

Refresh interval
Immediately once a match is finished

The team id comes from teams.

fromDate is required and must follow the YYYY-MM-DD format. timezone is optional, defaults to Etc/UTC, and narrows the results to your location.

Total, home and away

Each entry carries three sets. total covers every game, and home and away split the same figures by where the team played.

Each set holds games with played, wins and loses, and points with scored and received, so a home and away split needs no second request.

Parameters

Parameter Type Description
idrequired numberpath Requested team id.
fromDaterequired string Date that follows the YYYY-MM-DD format.e.g. 2023-08-06
timezoneoptional stringdefault Etc/UTC Valid timezone identifier.e.g. Europe/London

Request

curl --request GET \
  --url 'https://american-football.highlightly.net/teams/statistics/{id}?fromDate=2023-08-06' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  fromDate: '2023-08-06'
})
const response = await fetch(`https://american-football.highlightly.net/teams/statistics/{id}?${params}`, {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://american-football.highlightly.net/teams/statistics/{id}',
    params={
        'fromDate': '2023-08-06',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

totalAmfTeamTotalStatsResponserequiredTotal game and points statistics corresponding to specific league round.7 fields
gamesAmfTeamTotalGameStatsResponserequiredNumber of games team has played, won, and lost during a specific league round.3 fields
playednumberrequiredNumber of games team has played during a specific league round.
winsnumberrequiredNumber of games team has won during a specific league round.
losesnumberrequiredNumber of games team has lost during a specific league round.
pointsAmfTeamTotalPointsStatsResponserequiredNumber of points team has scored, and received during a specific league round.2 fields
scorednumberrequiredNumber of points team has scored during a specific league round.
receivednumberrequiredNumber of points team has received during a specific league round.
homeAmfTeamHomeStatsResponserequiredGame and point statistics corresponding to specific league round, where the team has played as a home team.7 fields
gamesAmfTeamHomeGameStatsResponserequiredNumber of games team has played, won, and lost during a specific league round, whilst playing as home team.3 fields
playednumberrequiredNumber of games team has played as home team during a specific league round.
winsnumberrequiredNumber of games team has won as home team during a specific league round.
losesnumberrequiredNumber of games team has lost as home team during a specific league round.
pointsAmfTeamHomePointsStatsResponserequiredNumber of points team has scored and received, during a specific league round, whilst playing as away team.2 fields
scorednumberrequiredNumber of points team has scored whilst playing as home team during a specific league round.
receivednumberrequiredNumber of points team has received whilst playing as home team during a specific league round.
awayAmfTeamAwayStatsResponserequiredGame and point statistics corresponding to specific league round, where the team has played as an away team.7 fields
gamesAmfTeamAwayGameStatsResponserequiredGame related statistics team has played as away team, during a specific league round.3 fields
playednumberrequiredNumber of games team has played as home team during a specific league round.
winsnumberrequiredNumber of games team has won as home team during a specific league round.
losesnumberrequiredNumber of games team has lost as home team during a specific league round.
pointsAmfTeamAwayPointsStatsResponserequiredNumber of points team has scored and received as away team, during a specific league round.2 fields
scorednumberrequiredNumber of points team has scored as away team, during a specific league round.
receivednumberrequiredNumber of points team has received as away team, during a specific league round.
leagueNamestringrequiredLeague name to which team statistics are associated.
roundstringrequiredRound to which team statistics are associated.

Example response

200 application/json 
[
  {
    "total": {
      "games": {
        "played": 67,
        "wins": 24,
        "loses": 43
      },
      "points": {
        "scored": 1369,
        "received": 1619
      }
    },
    "home": {
      "games": {
        "played": 33,
        "wins": 13,
        "loses": 20
      },
      "points": {
        "scored": 694,
        "received": 713
      }
    },
    "away": {
      "games": {
        "played": 34,
        "wins": 11,
        "loses": 23
      },
      "points": {
        "scored": 675,
        "received": 906
      }
    },
    "leagueName": "NFL",
    "round": "regular-season"
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.