Skip to main content
GET
/
competitions
/
featured
Featured Competitions
curl --request GET \
  --url https://v1.basketball.sportsapipro.com/competitions/featured \
  --header 'x-api-key: <api-key>'

​
Overview

Returns a curated list of featured competitions that have standings available. This endpoint is useful for displaying prominent leagues and tournaments to users, such as top football leagues (Premier League, LaLiga, Serie A, etc.).

​
Request

​
sports
integer
default:"1"
Sport type filter. Use 1 for Football.
​
type
string
default:"standings"
Filter type. Use standings to get competitions with standings support.
The following parameters are auto-resolved by the upstream service based on the user’s context:
  • appTypeId - Application type identifier
  • langId - Language identifier
  • timezoneName - User’s timezone (can be overridden, e.g., America/New_York)
  • userCountryId - User’s country for localization
All date/time fields use ISO 8601 format with a dynamic timezone offset.

​
Response

​
sports
array
Array of sport definitions included in the response.
​
countries
array
Array of countries that have featured competitions.
​
competitions
array
Array of featured competition objects.

​
Example Request

curl -X GET "https://v1.football.sportsapipro.com/competitions/featured?sports=1&type=standings" \
  -H "x-api-key: YOUR_API_KEY"

​
Example Response

{
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 19,
      "name": "Europe",
      "totalGames": 18,
      "liveGames": 0,
      "nameForURL": "europe",
      "imageVersion": 1,
      "isInternational": true
    },
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "sportTypes": [1, 9, 11],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitions": [
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "shortName": "EPL",
      "hasStandings": true,
      "hasBrackets": false,
      "hasStats": true,
      "hasTransfers": true,
      "hasLiveStandings": false,
      "hasStandingsGroups": false,
      "hasBets": false,
      "nameForURL": "premier-league",
      "popularityRank": 92856977,
      "tableName": "Standings",
      "currentSeasonNum": 131,
      "currentStageNum": 1,
      "color": "#075C9C",
      "competitorsType": 1,
      "imageVersion": 12,
      "hideOnCatalog": false,
      "hideOnSearch": false,
      "hasCurrentStageStandings": true,
      "hasHistory": true,
      "isActive": true
    },
    {
      "id": 572,
      "countryId": 19,
      "sportId": 1,
      "name": "UEFA Champions League",
      "shortName": "UCL",
      "hasStandings": true,
      "hasBrackets": true,
      "hasStats": true,
      "hasTransfers": false,
      "hasLiveStandings": false,
      "hasStandingsGroups": false,
      "hasBets": false,
      "nameForURL": "uefa-champions-league",
      "popularityRank": 115687338,
      "tableName": "Standings",
      "bracketsName": "Bracket",
      "currentSeasonNum": 73,
      "currentStageNum": 1,
      "color": "#09123E",
      "competitorsType": 1,
      "imageVersion": 5,
      "hideOnCatalog": false,
      "hideOnSearch": false,
      "hasCurrentStageStandings": true,
      "hasHistory": true,
      "isActive": true
    }
  ]
}

​
Use Cases

  • Featured Leagues Display: Show top leagues with standings on the homepage
  • Quick Navigation: Provide shortcuts to popular competitions
  • League Selector: Build a dropdown of featured leagues for filtering
  • Standings Widget: Display standings for multiple top leagues

​
Notes

  • Competitions are returned sorted by popularityRank (higher = more popular)
  • The type=standings filter ensures only competitions with standings support are returned
  • Use the hasStandings, hasBrackets, hasStats fields to determine available features
  • Competition logos can be retrieved via the Images API using the competition id

Authorizations

​
x-api-key
string
header
required

Your SportsAPI Pro API key

Response

200

Featured competitions retrieved successfully