Top Competitors

GET

competitors

top

Top Teams

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

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

fetch('https://api.sportsapipro.com/v1/basketball/competitors/top', 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/competitors/top",
  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/competitors/top"

	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/competitors/top")

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

Endpoint

GET https://api.sportsapipro.com/v1/football/competitors/top

Description

Returns the top competitors (teams/clubs) sorted by popularity, along with related sports and countries data. Useful for featuring popular teams on dashboards and navigation.

Parameters

Parameter	Type	Description
`limit`	number	Number of top competitors to return (e.g., 10, 20, 50)
`sports`	number	Filter by sport ID (e.g., 1 for Football)
`withSeasons`	boolean	Include season information for each competitor
`isDashboard`	boolean	Optimize response for dashboard display
`appTypeId`	number	Client application type identifier (auto-resolved)
`langId`	number	Language identifier (auto-resolved)
`timezoneName`	string	Timezone for date/time values (auto-resolved, or specify e.g., `America/New_York`)
`userCountryId`	number	User’s country for localization (auto-resolved)

Parameters marked as “auto-resolved” are automatically determined based on request context. You can override timezoneName with a specific timezone (e.g., America/New_York). All date/time fields use ISO 8601 format with a dynamic timezone offset.

Request

curl -X GET "https://api.sportsapipro.com/v1/football/competitors/top?limit=10&sports=1" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.sportsapipro.com/v1/football/competitors/top?limit=10&sports=1",
  {
    headers: { "x-api-key": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.sportsapipro.com/v1/football/competitors/top",
    params={"limit": 10, "sports": 1, "withSeasons": "true"},
    headers={"x-api-key": "YOUR_API_KEY"}
)
data = response.json()

Response

{
  "lastUpdateId": 5494749399,
  "requestedUpdateId": -1,
  "ttl": 300,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "sportTypes": [1, 9, 11],
      "imageVersion": 1,
      "isInternational": false
    },
    {
      "id": 2,
      "name": "Spain",
      "nameForURL": "spain",
      "sportTypes": [1, 2, 5, 8, 9],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitors": [
    {
      "id": 132,
      "countryId": 2,
      "sportId": 1,
      "name": "FC Barcelona",
      "shortName": "Barcelona",
      "symbolicName": "BAR",
      "nameForURL": "fc-barcelona",
      "type": 1,
      "popularityRank": 77506,
      "imageVersion": 3,
      "color": "#282E60",
      "awayColor": "#E2CFA5",
      "mainCompetitionId": 11,
      "hasSquad": true,
      "hasTransfers": false,
      "competitorNum": 0,
      "hideOnSearch": false,
      "hideOnCatalog": false
    },
    {
      "id": 131,
      "countryId": 2,
      "sportId": 1,
      "name": "Real Madrid",
      "symbolicName": "RMA",
      "nameForURL": "real-madrid",
      "type": 1,
      "popularityRank": 82570,
      "imageVersion": 4,
      "color": "#FFFFFF",
      "awayColor": "#464E69",
      "mainCompetitionId": 11,
      "hasSquad": true,
      "hasTransfers": false,
      "competitorNum": 0,
      "hideOnSearch": false,
      "hideOnCatalog": false
    }
  ]
}

Response Fields

Root Level

Field	Type	Description
`lastUpdateId`	number	Internal versioning ID for incremental updates
`requestedUpdateId`	number	The update ID requested (-1 means latest)
`ttl`	number	Cache time-to-live in seconds (typically 300)
`sports`	array	List of sports referenced by competitors
`countries`	array	List of countries referenced by competitors
`competitors`	array	List of top competitors sorted by popularity

Competitor Object

Field	Type	Description
`id`	number	Unique competitor identifier
`countryId`	number	ID of the country the competitor belongs to
`sportId`	number	ID of the sport (1 = Football)
`name`	string	Full competitor name
`shortName`	string	Abbreviated display name (e.g., “Barcelona”, “Man Utd”)
`longName`	string	Extended official name
`symbolicName`	string	3-letter code (e.g., “BAR”, “RMA”, “MUN”)
`nameForURL`	string	URL-friendly competitor name
`type`	number	Competitor type (1 = club, 2 = national team)
`popularityRank`	number	Popularity score (higher = more popular)
`imageVersion`	number	Version number for competitor logo assets
`color`	string	Primary brand color in hex format
`awayColor`	string	Away kit/secondary color in hex format
`mainCompetitionId`	number	Primary competition ID (e.g., domestic league)
`hasSquad`	boolean	Whether squad/roster data is available
`hasTransfers`	boolean	Whether transfer data is available
`competitorNum`	number	Internal competitor number
`hideOnSearch`	boolean	Whether hidden from search results
`hideOnCatalog`	boolean	Whether hidden from main catalog

Country Object

Field	Type	Description
`id`	number	Unique country identifier
`name`	string	Country display name
`nameForURL`	string	URL-friendly country name
`sportTypes`	array	Array of sport IDs available in this country
`imageVersion`	number	Version number for country flag assets
`isInternational`	boolean	Whether this is an international/continental region

Competitor Types

Type	Description
1	Club/Team (e.g., FC Barcelona, Manchester United)
2	National Team (e.g., Spain, England)

Top Football Clubs

Club	Country	ID	Competition
FC Barcelona	Spain	132	LaLiga
Real Madrid	Spain	131	LaLiga
Manchester United	England	105	Premier League
Chelsea	England	106	Premier League
Manchester City	England	110	Premier League
Liverpool	England	108	Premier League
Arsenal	England	104	Premier League
Bayern Munich	Germany	331	Bundesliga
Juventus	Italy	226	Serie A
PSG	France	480	Ligue 1

Competitor Images

Competitor logos can be accessed via the images proxy:

https://api.sportsapipro.com/v1/football/images/competitors/{id}?version={imageVersion}

Example:

https://api.sportsapipro.com/v1/football/images/competitors/132?version=3

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Response

200

Top teams retrieved successfully

Last modified on June 29, 2026

Top Teams

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

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

fetch('https://api.sportsapipro.com/v1/basketball/competitors/top', 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/competitors/top",
  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/competitors/top"

	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/competitors/top")

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

Endpoint

Description

Parameters

Request

Response

Response Fields

Root Level

Competitor Object

Country Object

Competitor Types

Top Football Clubs

Competitor Images

Authorizations

Response

​Endpoint

​Description

​Parameters

​Request

​Response

​Response Fields

​Root Level

​Competitor Object

​Country Object

​Competitor Types

​Top Football Clubs

​Competitor Images

Authorizations

Response

Endpoint

Description

Parameters

Request

Response

Response Fields

Root Level

Competitor Object

Country Object

Competitor Types

Top Football Clubs

Competitor Images