SoccerSTATS APIsoccerstats.com ↗
Access league tables, match scores, team stats, form tables, and standings from SoccerSTATS.com across dozens of football competitions via a single API.
What is the SoccerSTATS API?
The SoccerSTATS.com API exposes 9 endpoints covering league standings, match results, team season stats, and form tables across dozens of football competitions. Starting with get_available_leagues to enumerate all supported competitions, you can drill into league tables, individual match data including half-time scores, and team-level breakdowns that include streaks, seasonal stats, and comparisons against league averages.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5f3f185a-6cbf-4bef-9580-ee82088e525f/get_available_leagues' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace soccerstats-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""SoccerSTATS.com SDK — league standings, match results, team search, and stats."""
from parse_apis.soccerstats_com_api import SoccerStats, StatType, LeagueNotFound
client = SoccerStats()
# List available leagues, take the first few
for league_summary in client.leaguesummaries.list(limit=5):
print(league_summary.name, league_summary.slug)
# Construct a league and view its standings
england = client.league(slug="england")
for standing in england.table(limit=5):
print(standing.col_0, standing.col_1, standing.pts)
# Get a match and retrieve its stats
match = england.matches(limit=1).first()
if match:
print(match.date, match.home_team, match.score, match.away_team)
stats = england.match_stats(match_id=match.match_id)
print(stats.title, stats.match_id)
# Search for a team and get season performance
team = client.teamsearchresults.search(query="barcelona", limit=1).first()
if team:
print(team.name, team.team_id)
# Use the StatType enum to get clean sheet rankings
for row in england.stats_table(stat_type=StatType.CLEAN_SHEETS, limit=5):
print(row.values)
# Typed error handling for an invalid league
try:
bad_league = client.league(slug="nonexistent_league_xyz")
for s in bad_league.table(limit=1):
print(s.col_1)
except LeagueNotFound as exc:
print(f"League not found: {exc.league_slug}")
print("exercised: leaguesummaries.list / league.table / league.matches / league.match_stats / teamsearchresults.search / league.stats_table")
Retrieve the full list of available leagues and competitions covered by SoccerSTATS.com. Returns league name, slug identifier, and URL for each competition. The slug is used as the league_slug parameter in all other endpoints.
No input parameters required.
{
"type": "object",
"fields": {
"leagues": "array of league objects each containing name, slug, and url"
},
"sample": {
"data": {
"leagues": [
{
"url": "https://www.soccerstats.com/latest.asp?league=albania",
"name": "Albania - Abissnet Superiore",
"slug": "albania"
},
{
"url": "https://www.soccerstats.com/latest.asp?league=england",
"name": "England - Premier League",
"slug": "england"
}
]
},
"status": "success"
}
}About the SoccerSTATS API
League and Match Data
The get_available_leagues endpoint returns every competition available on SoccerSTATS.com as an array of objects, each with a name, slug, and url. That slug value is the key input across nearly every other endpoint. get_league_overview accepts a league_slug and returns the season summary including matches_played and avg_goals_per_match. get_league_table returns the full standings with columns mapped to GP, W, D, L, GF, GA, GD, and Pts; appending a year suffix to the slug (e.g. england_2024) retrieves historical seasons.
get_league_matches returns all fixtures and results for a league, with each match object carrying date, home_team, away_team, score, ht_score, and a match_id. That match_id feeds directly into get_match_stats, which returns the match title, league, and available stat sections such as domination, corners, and timing data when present for that fixture.
Team and Form Data
get_team_season_stats requires a team_id formatted as u{numeric_id}-{team-slug} — the numeric portion comes from search_team, which accepts a plain-text team name query and returns matching teams with their numeric identifiers and the league each belongs to. The season stats response includes streaks (home, away, and total sequences), seasonal match statistics, historical season comparisons, and vs_average data showing how the team compares to league averages.
get_league_form_table returns each team's recent form sequence alongside GP, W, D, L, GF, GA, GD, Pts, and opponent PPG (points per game), useful for identifying momentum trends. get_league_stats_table accepts a stat_type parameter (p for Both Teams To Score, y for Clean Sheets, cr for Corners, g for Streaks, z for Failed To Score) alongside a league_slug to retrieve ranked statistical breakdowns by category.
The SoccerSTATS API is a managed, monitored endpoint for soccerstats.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when soccerstats.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official soccerstats.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a standings tracker that pulls
get_league_tablefor multiple leagues and detects position changes week over week. - Aggregate
avg_goals_per_matchfromget_league_overviewacross leagues to compare offensive output by competition. - Use
get_league_matchescombined withget_match_statsto compile half-time vs full-time result conversion rates. - Feed
get_team_season_statsstreaks andvs_averagedata into a betting or fantasy sports model. - Use
get_league_form_tableopponent PPG field to weight recent results by fixture difficulty. - Query
get_league_stats_tablewithstat_type=pto rank teams by Both Teams To Score frequency for BTTS markets. - Use
search_teamto resolve team names to IDs before hydrating a multi-league team comparison dashboard.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SoccerSTATS.com have an official developer API?+
What does get_match_stats actually return beyond the score?+
title, league slug, and match_id. Additional stat sections — domination, corners, and timing breakdowns — are included when that data is present for the specific fixture. Not every match will have all sections populated.How do I retrieve a team's numeric ID for get_team_season_stats?+
search_team with a plain team name like 'arsenal' or 'barcelona'. The response returns an array of matching teams, each with a name (including the league in parentheses) and a numeric team_id. Combine it as u{team_id}-{team-slug} when calling get_team_season_stats. Providing a malformed team_id will return an upstream error rather than an empty result.Does the API cover player-level statistics such as goals scored or assists per player?+
Is historical season data available for all endpoints?+
get_league_table supports historical seasons by appending a year suffix to the league slug (e.g. england_2024). The get_team_season_stats endpoint also returns a historical array of past season comparisons for a team. Other endpoints such as get_league_matches and get_league_form_table reflect the current season only. You can fork this API on Parse and revise it to add historical match retrieval by season.