Featured Competitions

Retrieve featured competitions with standings support, organized by sport type

GET /competitions/featured

Featured Competitions

cURL

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 based on request 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.

Show Sport object properties

id · integer

Sport identifier (1 = Football)

name · string

Display name of the sport

nameForURL · string

URL-safe name

drawSupport · boolean

Whether the sport supports draws

imageVersion · integer

Version number for sport image

countries · array

Array of countries that have featured competitions.

Show Country object properties

id · integer

Country identifier

name · string

Country name

nameForURL · string

URL-safe country name

totalGames · integer

Total number of games (optional)

liveGames · integer

Number of live games (optional)

sportTypes · array

Array of sport IDs available in this country

imageVersion · integer

Version number for country flag image

isInternational · boolean

Whether this is an international entity (e.g., Europe)

competitions · array

Array of featured competition objects.

Show Competition object properties

id · integer

Competition identifier

countryId · integer

Country the competition belongs to

sportId · integer

Sport type (1 = Football)

name · string

Full competition name

shortName · string

Abbreviated name (optional)

longName · string

Extended name (optional)

nameForURL · string

URL-safe competition name

hasStandings · boolean

Whether standings are available

hasBrackets · boolean

Whether bracket/knockout data is available

hasStats · boolean

Whether statistics are available

hasTransfers · boolean

Whether transfer data is available

hasLiveStandings · boolean

Whether live standings updates are supported

hasStandingsGroups · boolean

Whether standings have group stages

hasBets · boolean

Whether betting data is available

hasCurrentStageStandings · boolean

Whether current stage has standings

hasHistory · boolean

Whether historical data is available

isActive · boolean

Whether the competition is currently active

popularityRank · integer

Popularity score for sorting

tableName · string

Display name for standings table

bracketsName · string

Display name for bracket view (optional)

currentSeasonNum · integer

Current season number

currentStageNum · integer

Current stage number

currentPhaseName · string

Name of current phase (optional)

color · string

Brand color (hex format)

competitorsType · integer

Type of competitors (1 = clubs)

imageVersion · integer

Version number for competition logo

createdAt · string

ISO timestamp when competition was added (optional)

hideOnCatalog · boolean

Whether to hide in catalog view

hideOnSearch · boolean

Whether to hide in search results

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