Skip to main content

​
Base URL

https://api.sportsapipro.com/v2/football
Season IDs must be discovered dynamically. Always call /api/tournaments/{id}/seasons first to get the numeric seasonId. The human-readable name field — "24/25" for European leagues or "2024" for calendar-year leagues like MLS and Brazilian Série A — is for display only and is not a valid URL parameter. See the Season IDs guide for full examples.

​
Seasons

​
Get Tournament Seasons

GET /api/tournaments/{id}/seasons
Returns all available seasons for a tournament. Call this first to discover valid seasonId values for other endpoints.
​
id
number
required
Numeric tournament ID. Use /api/search?q=premier+league or /api/leagues to discover.
Season name vs id — only the id is valid in downstream URLs. Sample response:
{
  "seasons": [
    { "id": 61627, "name": "24/25", "year": "24/25" },
    { "id": 61644, "name": "2024",  "year": "2024"  }
  ]
}
Pass 61627 (not "24/25") and 61644 (not "2024") to every /season/{seasonId}/... endpoint. See Season IDs for split-year vs calendar-year worked examples.

​
Standings

​
Overall Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings
Returns the full league table with points, wins, draws, losses, goals for/against, and goal difference.

​
Home Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings/home
Returns standings based on home matches only.

​
Away Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings/away
Returns standings based on away matches only.

​
Statistics & Rankings

​
Top Players

GET /api/tournament/{tournamentId}/season/{seasonId}/top-players?type={type}
Returns top-performing players in the tournament season (top scorers, assists, etc.).
​
type
string
default:"overall"
Filter by match location: overall, home, or away.

​
Top Teams

GET /api/tournament/{tournamentId}/season/{seasonId}/top-teams?type={type}
Returns top-performing teams by various metrics.

​
Top Ratings

GET /api/tournament/{tournamentId}/season/{seasonId}/top-ratings?type={type}
Returns player ratings leaderboard for the season.

​
Season Statistics

GET /api/tournament/{tournamentId}/season/{seasonId}/statistics
Returns aggregate season statistics: total goals, cards, average goals per match, etc.

​
Statistics Info

GET /api/tournament/{tournamentId}/season/{seasonId}/statistics/info
Returns metadata about available statistics types for the season.

​
Player Statistics Types

GET /api/tournament/{tournamentId}/season/{seasonId}/player-statistics/types
Returns available player statistic categories (e.g., goals, assists, tackles, saves).

​
Team Statistics Types

GET /api/tournament/{tournamentId}/season/{seasonId}/team-statistics/types
Returns available team statistic categories.

​
Player of the Season

GET /api/tournament/{tournamentId}/season/{seasonId}/player-of-the-season
Returns the player of the season award details, including nominees and winner.

​
Rounds & Events

​
All Rounds

GET /api/tournament/{tournamentId}/season/{seasonId}/rounds
Returns all matchday rounds for the season with round numbers and status.
League-format only. Some competitions (e.g. MLS, Brazilian Série A, and other regular-season/playoff leagues) do not expose traditional matchday rounds and will return a 404 here. Use /standings plus /events/last/{page} and /events/next/{page} for those tournaments instead.

​
Round Matches

GET /api/tournament/{tournamentId}/season/{seasonId}/round/{round}
Returns all matches in a specific round/matchday.

​
Events by Round

GET /api/tournament/{tournamentId}/season/{seasonId}/events/round/{round}
Returns detailed event data for a specific round.

​
Events by Round & Slug

GET /api/tournament/{tournamentId}/season/{seasonId}/events/round/{round}/slug/{slug}
Returns events filtered by round and slug identifier.

​
Last Events (Paginated)

GET /api/tournament/{tournamentId}/season/{seasonId}/events/last/{page}
Returns recent completed matches in the tournament, paginated. Page 0 returns the most recent.
​
page
number
required
Page number (0-indexed). Start with 0 for the most recent events.

​
Next Events (Paginated)

GET /api/tournament/{tournamentId}/season/{seasonId}/events/next/{page}
Returns upcoming scheduled matches in the tournament season, paginated (30 per page). Page 0 returns the soonest upcoming events.
​
page
number
required
Page number (0-indexed). Start with 0 for the next batch of upcoming events.

​
Season Teams

GET /api/tournament/{tournamentId}/season/{seasonId}/teams
Returns all teams participating in a given season — useful for cup competitions and qualifying tournaments where the entrant list varies year to year.

​
Brackets & Cup Tournaments

​
Knockout / Cup Tree

GET /api/tournament/{tournamentId}/season/{seasonId}/knockout
Returns the bracket/knockout tree for cup tournaments (e.g., FA Cup, Champions League). Includes all rounds from Round of 32 to the Final.

​
Draw / Bracket (Alias)

GET /api/tournament/{tournamentId}/season/{seasonId}/draw
Alias for the knockout endpoint — returns the same bracket/draw data.
Only available for cup/knockout tournaments. League tournaments will return empty data.

​
Team of the Week

​
Available Periods

GET /api/tournament/{tournamentId}/season/{seasonId}/team-of-the-week/periods
Returns available Team of the Week periods (matchdays). Use the returned periodId values to fetch specific team-of-the-week selections.

​
Team of the Week by Period

GET /api/tournament/{tournamentId}/season/{seasonId}/team-of-the-week/{periodId}
Returns the best XI for a specific matchday period, including formation, player ratings, and key stats.
​
periodId
number
required
Period ID from the /team-of-the-week/periods endpoint.

​
Team Performance

​
Team Performance Graph

GET /api/tournament/{tournamentId}/season/{seasonId}/team/{teamId}/performance-graph
Returns a team’s performance trajectory over the season — position changes after each matchday.

​
Team Events

GET /api/tournament/{tournamentId}/season/{seasonId}/team-events?type={type}
Returns all events for teams in the tournament season.
​
type
string
default:"total"
Filter: total, home, or away.

​
Tournament Info

​
Tournament Details

GET /api/tournament/{tournamentId}/info
Returns tournament metadata: name, country, logo, tier, and current season.

​
Season Info

GET /api/tournament/{tournamentId}/season/{seasonId}/info
Returns season-specific information: start/end dates, number of teams, current round. 
GET /api/tournament/{tournamentId}/featured-events
Returns highlighted/featured matches for the tournament (e.g., derbies, title deciders).

​
Tournament Image

GET /api/tournament/{tournamentId}/image
Returns the tournament logo/badge image URL.

​
Tournament Media

GET /api/tournament/{tournamentId}/media
Returns media content (photos, videos) for the tournament.
Not all tournaments have media content. Top-tier leagues are more likely to have media available.

​
Venues

GET /api/tournament/{tournamentId}/season/{seasonId}/venues
Returns all venues used in the tournament season, with capacity, location, and coordinates.

​
Scheduled Events by Date

GET /api/tournament/{tournamentId}/scheduled-events/{date}
Returns all events for this tournament on a specific date.
​
date
string
required
Date in YYYY-MM-DD format (e.g., 2025-03-15).

​
Example Requests

# Step 1: Discover seasons
curl -X GET "https://api.sportsapipro.com/v2/football/tournaments/17/seasons" \
  -H "x-api-key: YOUR_API_KEY"

# Step 2: Use a valid seasonId from the response
curl -X GET "https://api.sportsapipro.com/v2/football/tournament/17/season/61627/standings" \
  -H "x-api-key: YOUR_API_KEY"
Last modified on June 29, 2026