Related Entities

Retrieve related entities for a competitor, competition, or athlete including rival teams, related competitions, and popular players

GET /relatedEntities

Related Entities

cURL

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.

Show Sport Object

id · integer

Unique sport identifier.

name · string

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

nameForURL · string

URL-safe sport name.

drawSupport · boolean

Whether the sport supports draw results.

imageVersion · integer

Image version for sport icon.

countries · array

Array of countries associated with related entities.

Show Country Object

id · integer

Unique country identifier.

name · string

Country name.

nameForURL · string

URL-safe country name.

sportTypes · array

Array of sport IDs active in this country.

imageVersion · integer

Image version for country flag.

isInternational · boolean

Whether this is an international/continental entity.

competitions · array

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

Show Competition Object

id · integer

Unique competition identifier.

countryId · integer

Country or region ID.

sportId · integer

Sport identifier.

name · string

Competition name.

shortName · string

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

longName · string

Full competition name.

nameForURL · string

URL-safe competition name.

popularityRank · integer

Popularity score for sorting.

imageVersion · integer

Image version for competition logo.

competitorsType · integer

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

competitors · array

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

Show Competitor Object

id · integer

Unique competitor identifier.

countryId · integer

Country ID.

sportId · integer

Sport identifier.

name · string

Team name.

shortName · string

Short display name.

longName · string

Full official name.

nameForURL · string

URL-safe team name.

popularityRank · integer

Popularity score (higher = more popular).

imageVersion · integer

Image version for team logo.

mainCompetitionId · integer

Primary league/competition ID.

mainCompetitionName · string

Primary competition name.

hasTransfers · boolean

Whether transfer data is available.

athletes · array

Array of related athletes (players, managers).

Show Athlete Object

id · integer

Unique athlete identifier.

name · string

Full athlete name.

shortName · string

Display name (usually surname).

nameForURL · string

URL-safe athlete name.

sportId · integer

Sport identifier.

clubId · integer

Current club/team ID.

clubName · string

Current club name.

nationalityId · integer

Country ID of nationality.

popularityRank · integer

Popularity score (higher = more popular).

imageVersion · integer

Image version for athlete photo.

createdAt · string

ISO 8601 timestamp when record was created.

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