Skip to main content
GET
/
relatedEntities
Related Entities
curl --request GET \
  --url https://v1.football.sportsapipro.com/relatedEntities \
  --header 'x-api-key: <api-key>'

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

competitors
string
Comma-separated list of competitor IDs to find related entities for.
competitions
string
Comma-separated list of competition IDs to find related entities for.
athletes
string
Comma-separated list of athlete IDs to find related entities for.
appTypeId
integer
Application type identifier (resolved automatically).
langId
integer
Language identifier (resolved automatically).
timezoneName
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.
userCountryId
integer
Country identifier for localization (resolved automatically).
At least one of competitors, competitions, or athletes is required.

Response Structure

sports
array
Array of sport definitions relevant to the related entities.
countries
array
Array of countries associated with related entities.
competitions
array
Array of related competitions (leagues, cups, tournaments).
competitors
array
Array of related competitors/teams (rivals, league opponents).
athletes
array
Array of related athletes (players, managers).

Example Request

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

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

# Get related entities for multiple entities
curl -X GET "https://v1.football.sportsapipro.com/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