Featured Competitions

GET

competitions

featured

curl --request GET \
  --url https://api.sportsapipro.com/v1/basketball/competitions/featured \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/competitions/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/competitions/featured",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/competitions/featured"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/competitions/featured")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

integer

default:"1"

Sport type filter. Use 1 for Football.

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

array

Array of sport definitions included in the response.

Show Sport object properties

integer

Sport identifier (1 = Football)

string

Display name of the sport

string

URL-safe name

boolean

Whether the sport supports draws

integer

Version number for sport image

array

Array of countries that have featured competitions.

Show Country object properties

integer

Country identifier

string

Country name

string

URL-safe country name

integer

Total number of games (optional)

integer

Number of live games (optional)

array

Array of sport IDs available in this country

integer

Version number for country flag image

boolean

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

array

Array of featured competition objects.

Show Competition object properties

integer

Competition identifier

integer

Country the competition belongs to

integer

Sport type (1 = Football)

string

Full competition name

string

Abbreviated name (optional)

string

Extended name (optional)

string

URL-safe competition name

boolean

Whether standings are available

boolean

Whether bracket/knockout data is available

boolean

Whether statistics are available

boolean

Whether transfer data is available

boolean

Whether live standings updates are supported

boolean

Whether standings have group stages

boolean

Whether betting data is available

boolean

Whether current stage has standings

boolean

Whether historical data is available

boolean

Whether the competition is currently active

integer

Popularity score for sorting

string

Display name for standings table

string

Display name for bracket view (optional)

integer

Current season number

integer

Current stage number

string

Name of current phase (optional)

string

Brand color (hex format)

integer

Type of competitors (1 = clubs)

integer

Version number for competition logo

string

ISO timestamp when competition was added (optional)

boolean

Whether to hide in catalog view

boolean

Whether to hide in search results

Example Request

curl -X GET "https://api.sportsapipro.com/v1/football/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

Last modified on June 29, 2026

Featured Competitions

curl --request GET \
  --url https://api.sportsapipro.com/v1/basketball/competitions/featured \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/competitions/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/competitions/featured",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/competitions/featured"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/competitions/featured")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Request

Response

Example Request

Example Response

Use Cases

Notes

Authorizations

Response

​Overview

​Request

​Response

​Example Request

​Example Response

​Use Cases

​Notes

Authorizations

Response

Overview

Request

Response

Example Request

Example Response

Use Cases

Notes