Related Entities

GET

relatedEntities

Related Entities

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

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

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

	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/football/relatedEntities")

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 entities that are related to the queried competitor, competition, or athlete. This includes rival teams, competitions the entity participates in, and popular athletes. Useful for building “Related Content” sections and discovery features.

Query Parameters

string

Comma-separated list of competitor IDs to find related entities for.

string

Comma-separated list of competition IDs to find related entities for.

string

Comma-separated list of athlete IDs to find related entities for.

integer

Application type identifier (resolved automatically).

integer

Language identifier (resolved automatically).

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All date/time fields use ISO 8601 format with a dynamic timezone offset.

integer

Country identifier for localization (resolved automatically).

At least one of competitors, competitions, or athletes is required.

Response Structure

array

Array of sport definitions relevant to the related entities.

Show Sport Object

integer

Unique sport identifier.

string

Sport name (e.g., “Football”).

string

URL-safe sport name.

boolean

Whether the sport supports draw results.

integer

Image version for sport icon.

array

Array of countries associated with related entities.

Show Country Object

integer

Unique country identifier.

string

Country name.

string

URL-safe country name.

array

Array of sport IDs active in this country.

integer

Image version for country flag.

boolean

Whether this is an international/continental entity.

array

Array of related competitions (leagues, cups, tournaments).

Show Competition Object

integer

Unique competition identifier.

integer

Country or region ID.

integer

Sport identifier.

string

Competition name.

string

Abbreviated name (e.g., “UCL”, “EPL”).

string

Full competition name.

string

URL-safe competition name.

integer

Popularity score for sorting.

integer

Image version for competition logo.

integer

Type of competitors (0 = clubs, 1 = national teams).

array

Array of related competitors/teams (rivals, league opponents).

Show Competitor Object

integer

Unique competitor identifier.

integer

Country ID.

integer

Sport identifier.

string

Team name.

string

Short display name.

string

Full official name.

string

URL-safe team name.

integer

Popularity score (higher = more popular).

integer

Image version for team logo.

integer

Primary league/competition ID.

string

Primary competition name.

boolean

Whether transfer data is available.

array

Array of related athletes (players, managers).

Show Athlete Object

integer

Unique athlete identifier.

string

Full athlete name.

string

Display name (usually surname).

string

URL-safe athlete name.

integer

Sport identifier.

integer

Current club/team ID.

string

Current club name.

integer

Country ID of nationality.

integer

Popularity score (higher = more popular).

integer

Image version for athlete photo.

string

ISO 8601 timestamp when record was created.

Example Request

# Get related entities for Manchester City
curl -X GET "https://api.sportsapipro.com/v1/football/relatedEntities?competitors=110" \
  -H "x-api-key: YOUR_API_KEY"

# Get related entities for Premier League
curl -X GET "https://api.sportsapipro.com/v1/football/relatedEntities?competitions=7" \
  -H "x-api-key: YOUR_API_KEY"

# Get related entities for multiple entities
curl -X GET "https://api.sportsapipro.com/v1/football/relatedEntities?competitors=110,108" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "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": 19,
      "name": "Europe",
      "nameForURL": "europe",
      "sportTypes": [1, 2, 4, 5, 6, 7, 8, 9],
      "imageVersion": 1,
      "isInternational": true
    }
  ],
  "competitions": [
    {
      "id": 572,
      "countryId": 19,
      "sportId": 1,
      "name": "UEFA Champions League",
      "shortName": "UCL",
      "nameForURL": "uefa-champions-league",
      "popularityRank": 115687338,
      "imageVersion": 5
    },
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "shortName": "EPL",
      "nameForURL": "premier-league",
      "popularityRank": 92856977,
      "imageVersion": 12
    }
  ],
  "competitors": [
    {
      "id": 105,
      "countryId": 1,
      "sportId": 1,
      "name": "Manchester United",
      "shortName": "Man Utd",
      "nameForURL": "manchester-united",
      "popularityRank": 53964932,
      "imageVersion": 1,
      "mainCompetitionId": 7,
      "mainCompetitionName": "Premier League"
    },
    {
      "id": 108,
      "countryId": 1,
      "sportId": 1,
      "name": "Liverpool",
      "nameForURL": "liverpool",
      "popularityRank": 53493300,
      "imageVersion": 22,
      "mainCompetitionId": 7,
      "mainCompetitionName": "Premier League"
    }
  ],
  "athletes": [
    {
      "id": 65760,
      "name": "Erling Haaland",
      "shortName": "Haaland",
      "nameForURL": "erling-haaland",
      "sportId": 1,
      "clubId": 110,
      "nationalityId": 27,
      "popularityRank": 1025,
      "imageVersion": 67,
      "clubName": "Manchester City"
    },
    {
      "id": 46494,
      "name": "Phil Foden",
      "shortName": "Foden",
      "nameForURL": "phil-foden",
      "sportId": 1,
      "clubId": 110,
      "nationalityId": 1,
      "popularityRank": 285,
      "imageVersion": 49,
      "clubName": "Manchester City"
    }
  ]
}

Use Cases

Related Teams: Show rival teams and league opponents on team pages
Competition Discovery: Display competitions a team participates in
Player Highlights: Feature popular players from a team
Content Recommendations: Build “You might also like” sections
Navigation: Create related content sidebars and footers
SEO Internal Linking: Generate contextual links between related entities

Notes

Entities are sorted by popularityRank (higher values = more popular)
The response includes managers in the athletes array (e.g., Pep Guardiola)
Related competitors typically include league rivals and recent opponents
International competitions (e.g., Champions League) have isInternational: true in countries

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

entityType

string

required

Entity type (team, player, competition)

Example:

"team"

entityId

integer

required

Entity identifier

Example:

131

Response

200

Related entities retrieved successfully

Last modified on June 29, 2026

Related Entities

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

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

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

	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/football/relatedEntities")

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

Query Parameters

Response Structure

Example Request

Example Response

Use Cases

Notes

Authorizations

Query Parameters

Response

​Overview

​Query Parameters

​Response Structure

​Example Request

​Example Response

​Use Cases

​Notes

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response Structure

Example Request

Example Response

Use Cases

Notes