NFL & NCAAF API / standings

Standings

GET https://american-football.highlightly.net/standings NFL & NCAAF API
GET https://sports.highlightly.net/american-football/standings All Sports API

Retrieve standings for a specific league, conference or division.

Refresh interval
Up to an hour after a match for the associated league and season is finished
Pagination
limit and offset

There are several ways to fetch the data. Use abbreviation or leagueName to pick the conference, leagueType to filter by league type, such as NFL, and year to choose the season.

Conferences

abbreviation is the short code, and leagueName is the written out form. Either works.

League name Abbreviation
American Football Conference AFC
National Football Conference NFC
American Athletic Conference AAC
Atlantic Coast Conference ACC
Big 12 Conference BIG12
Big Ten Conference BIG10
Conference USA USA
Mid-American Conference MIDAM
Mountain West Conference MWEST
Pac-12 Conference PAC12
Southeastern Conference SEC
Sun Belt - East BELTE
Sun Belt - West BELTW
FBS Independents IND

Every entry carries leagueType. Pass leagueType to get only one league.

Choosing a season

year narrows standings to a single season, such as 2024.

Standings rendered in a client application

Parameters

Parameter Type Description
leagueTypeoptional string No description in the spec.e.g. NFL
limitoptional numberdefault 10 No description in the spec.e.g. 5
offsetoptional numberdefault 0 No description in the spec.e.g. 0
leagueNameoptional string No description in the spec.e.g. National Football Conference
abbreviationoptional string No description in the spec.e.g. NFC
yearoptional number No description in the spec.e.g. 2024

Request

curl --request GET \
  --url 'https://american-football.highlightly.net/standings?leagueType=NFL&leagueName=National%20Football%20Conference' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  leagueType: 'NFL',
  leagueName: 'National Football Conference'
})
const response = await fetch(`https://american-football.highlightly.net/standings?${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/standings',
    params={
        'leagueType': 'NFL',
        'leagueName': 'National Football Conference',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

dataAmericanFootballStandingsDataResponse[]required17 fields
leagueNamestringrequired
abbreviationstringrequired
yearnumberrequired
leagueTypestringrequired
seasonTypestringrequired
startDatestringrequired
endDatestringrequired
dataAmericanFootballTeamStatsResponse[]required9 fields
teamAmericanFootballStandingsTeamResponserequired5 fields
idnumberrequired
logostringrequired
namestringrequired
displayNamestringrequired
abbreviationstringrequired
statisticsAmericanFootballStatsValueResponse[]required2 fields
valuestringrequired
displayNamestringrequired
paginationPaginationResponserequired3 fields
totalCountnumberrequiredAvailable number of items, relevant to the provided query.
offsetnumberrequired
limitnumberrequired
planPlanResponserequired2 fields
tierstringrequiredYour current API subscription tier.
messagestringrequiredExplanation message regarding your current tier.

Example response

200 application/json 
{
  "data": [
    {
      "leagueName": "American Football Conference",
      "abbreviation": "AFC",
      "year": 2024,
      "leagueType": "NFL",
      "seasonType": "Preseason",
      "startDate": "2024-08-01T07:00:00.000Z",
      "endDate": "2024-09-05T06:59:00.000Z",
      "data": [
        {
          "team": {
            "id": 3,
            "logo": "https://highlightly.net/american-football/images/teams/3.png",
            "name": "Broncos",
            "displayName": "Denver Broncos",
            "abbreviation": "DEN"
          },
          "statistics": [
            {
              "value": "+4",
              "displayName": "Differential"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "totalCount": 490,
    "offset": 20,
    "limit": 100
  },
  "plan": {
    "tier": "BASIC",
    "message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
  }
}

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.