SofaScore match, player and team statistics as JSON: xG, ratings, heatmaps, transfers, tables
- endpoints
- 38
- credits per call
- 1–2
The SofaScore API returns SofaScore's match, player, team and competition statistics as JSON: match statistics (possession, shots, xG), lineups with per-player ratings, attack momentum, incidents, best players, head-to-head, managers, odds, average positions, a player's heatmap and shotmap in a match; player profiles, season statistics, season heatmaps, attribute radars, transfer histories and recent matches; team profiles, squads, transfers, season statistics, form and goal distributions; league tables (overall, home, away), season top players and teams, team of the week, power rankings, cup trees and competition details; manager and referee profiles; and the FIFA, ATP and WTA world rankings.
/sofascore/v1
- POST/sofascore/v1/entity_search1 credit
- POST/sofascore/v1/live_events1 credit
- POST/sofascore/v1/scheduled_events1 credit
- POST/sofascore/v1/tournament_seasons1 credit
- POST/sofascore/v1/match_statistics2 credits
- POST/sofascore/v1/match_lineups2 credits
- POST/sofascore/v1/match_momentum1 credit
- POST/sofascore/v1/match_incidents1 credit
- POST/sofascore/v1/match_best_players1 credit
- POST/sofascore/v1/match_h2h1 credit
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
SofaScore API
4 of 38 endpoints, ready to run
A name to SofaScore ids: players, teams, competitions, managers, referees
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What SofaScore endpoints does ReefAPI ship?
38 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
entity_search
1 crsearch players/teams/tournaments/managers/referees → SofaScore ids.
- required
- query
- optional
- —
live_events
1 crall in-play events for a sport.
- required
- sport
- optional
- —
scheduled_events
1 crall scheduled events for a sport on a date.
- required
- sport, date
- optional
- —
tournament_seasons
1 crEvery season available for a competition (season id + year).
- required
- league
- optional
- —
match_statistics
2 crdetailed match stats (possession/shots/xG).
- required
- event_id
- optional
- —
match_lineups
2 crlineups + per-player ratings & stats.
- required
- event_id
- optional
- —
match_momentum
1 crattack-momentum graph.
- required
- event_id
- optional
- —
match_incidents
1 crgoal/card/sub timeline.
- required
- event_id
- optional
- —
match_best_players
1 crbest player per team.
- required
- event_id
- optional
- —
match_h2h
1 crhead-to-head duel record.
- required
- event_id
- optional
- —
match_managers
1 crboth managers for a match.
- required
- event_id
- optional
- —
match_odds
2 crmulti-market odds for a match.
- required
- event_id
- optional
- —
match_player_heatmap
1 cra player's touch heatmap in a match.
- required
- event_id, player_id
- optional
- —
match_player_shotmap
1 cra player's shotmap in a match.
- required
- event_id, player_id
- optional
- —
match_average_positions
1 craverage player positions on the pitch.
- required
- event_id
- optional
- —
player
1 crPlayer profile.
- required
- player_id
- optional
- —
player_season_stats
2 crplayer's season statistics in a league.
- required
- player_id, league
- optional
- season, type
player_heatmap
1 crplayer's season heatmap.
- required
- player_id, league
- optional
- season
player_attributes
1 crplayer attribute radar (att/tech/tac/def/cre).
- required
- player_id
- optional
- —
player_transfers
1 crA player's full transfer history (from/to club, fee, date) by SofaScore player id.
- required
- player_id
- optional
- —
player_recent
1 crplayer's recent matches.
- required
- player_id
- optional
- —
team_details
1 crTeam profile.
- required
- team_id
- optional
- —
team_squad
1 crA club's full current squad (every player with id, position, value) by SofaScore team id.
- required
- team_id
- optional
- —
team_transfers
1 crA club's transfers in and out (player, club, fee, date) by SofaScore team id.
- required
- team_id
- optional
- —
team_season_stats
2 crteam's season statistics in a league.
- required
- team_id, league
- optional
- season, type
team_form
1 crteam recent form + next/prev event.
- required
- team_id
- optional
- —
team_goal_distributions
1 crgoals scored/conceded by match period.
- required
- team_id, league
- optional
- season
season_standings
2 crSofaScore league table for a competition (overall / home / away splits) with goals for/agains…
- required
- league
- optional
- season, type
season_top_players
2 crseason leaders by category.
- required
- league
- optional
- season, type
season_top_teams
2 crseason top teams by category.
- required
- league
- optional
- season, type
team_of_week
2 crteam of the week (round or rounds list).
- required
- league
- optional
- season, round_id
power_rankings
2 crseason power rankings.
- required
- league
- optional
- season, round_id
cup_tree
2 crknockout bracket / cup tree.
- required
- league
- optional
- season
tournament_details
1 crCompetition metadata.
- required
- league
- optional
- —
manager
1 crManager profile and full club-by-club career history (matches, wins, points) by SofaScore man…
- required
- manager_id
- optional
- —
referee
1 crreferee details + per-tournament stats.
- required
- referee_id
- optional
- —
rankings
1 crWorld rankings.
- required
- —
- optional
- type
leagues
1 crDirectory of every supported league/competition (key, name, sport).
- required
- —
- optional
- sport
Every parameter, every allowed value →
Missing a SofaScore endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the SofaScore API works
SofaScore is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a player's name to a full season profile
Find the SofaScore id, read the season statistics, then the profile, transfers and heatmap.
{"query": "Haaland"}On 2026-11-21: 18 matches, first Erling Haaland (player, id 839956, Norway), then other players named Haaland with their ids and countries.
{"player_id": "839956", "league": "eng.1"}The current Premier League season for Manchester City's Haaland on 2026-11-21: 139 statistic fields, among them 11 appearances, 980 minutes, 9 goals, expected goals 8.09, 42 shots (19 on target), average rating 7.55 and 104.7 km covered with 130 sprints.
{"player_id": "839956"}Every transfer with the clubs, fee and date; player returns the profile with position, market value, preferred foot, height and contract.
{"player_id": "839956", "league": "eng.1"}The season heatmap as x, y points. Old calls to POST /sports-data/v1/<action> keep working unchanged; the call for SofaScore is POST /sofascore/v1/<action>.
A player's season in numbers (goals, xG, shots, passing, duels, running) next to his profile and transfer history, keyed by SofaScore ids.
curl -X POST https://api.reefapi.com/sofascore/v1/entity_search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Haaland"}'{
"ok": true,
"data": { … },
"meta": {
"api": "sofascore",
"endpoint": "entity_search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a SofaScore field actually contains
Fields that read differently from how they look. Measured on live SofaScore data on 2026-11-21 (entity_search "Haaland" and player_season_stats for player 839956 in the Premier League), plus the parameter rules of the actions.
| Field or input | What it holds |
|---|---|
| entity_search results[] | type (player, team, tournament, manager, referee), SofaScore id, name, slug and country. 18 rows for "Haaland"; the sport field was empty on all 18. |
| player_id, team_id, event_id | SofaScore's own numbers, not ESPN's. 839956 = Erling Haaland. Match actions take a SofaScore match id, which live_events, player_recent and team_form return. |
| league | A league key (eng.1, esp.1, ita.1, ger.1, fra.1, uefa.champions, nba), a competition name to search, or a SofaScore tournament id. eng.1 resolved to the Premier League. |
| season, season_id | season is a year; omit it for the current season. season_id is SofaScore's season number (tournament_seasons lists them) and skips the lookup. |
| player_season_stats statistics | 139 fields for one player and competition, all numbers: goals, assists, expectedGoals (8.0931), expectedAssists (0.9115), totalShots, shotsOnTarget, bigChancesMissed, headedGoals, accuratePassesPercentage (64.44), touches, duels, tackles, rating (7.5545), minutesPlayed, plus running data: kilometersCovered (104.69), numberOfSprints (130), topSpeed (35.33). |
| type on season stats | overall, home or away split. Other SofaScore split names are passed on; a wrong one returns NOT_FOUND. |
| rankings type | fifa (default), atp or wta. Any other value returns INVALID_PARAM. |
Percentages and averages come with SofaScore's full decimals (rating 7.5545454545455); round them yourself.
SofaScore coverage, measured
Numbers below come from live calls on 2026-11-21; ids are SofaScore's own.
37 SofaScore actions plus a league-key directory: 11 per match (statistics, lineups, momentum, incidents, best players, head-to-head, managers, odds, average positions, a player's heatmap and shotmap), 6 per player, 6 per team, 8 per competition and season (standings, top players, top teams, team of the week, power rankings, cup tree, details, seasons), manager, referee, FIFA/ATP/WTA rankings, search, live events and scheduled events.
entity_search "Haaland" returned 18 results in 0.75 seconds, each with type, SofaScore id, name, slug and country; Erling Haaland is id 839956. The sport field was empty on all 18 rows.
player_season_stats for Erling Haaland in the Premier League returned 139 fields: 9 goals and 0 assists in 11 starts and 980 minutes, expected goals 8.09, expected assists 0.91, 42 shots with 19 on target, 8 big chances missed, 4 headed goals, 64.4% pass accuracy, 253 touches, 104.7 km covered, 130 sprints and a top speed of 35.3.
League keys from the directory (eng.1, esp.1, ita.1, ger.1, fra.1 and more) map to SofaScore competitions; any SofaScore tournament id or a competition name also works. eng.1 resolved to the Premier League on 2026-11-21.
SofaScore ids are not ESPN ids: teams, players and matches each have their own SofaScore number. Match actions need a SofaScore match id, which live_events, player_recent and team_form return. rankings takes fifa, atp or wta only.
What people build with SofaScore
The jobs this data is most often used for.
Build player scouting profiles from season statistics, xG, attribute radars and heatmaps.
Show match centres with statistics, lineups with ratings, momentum and the incident timeline.
Track transfers and market values of players and clubs.
Feed fantasy football and prediction models with per-player season data.
endpoints
credits per call
What SofaScore data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/sofascore/v1/entity_search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Haaland"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/sofascore/v1/entity_search",
headers={"x-api-key": REEF_KEY},
json={
"query": "Haaland"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up SofaScore.
Is there a SofaScore API?▾
Yes. The SofaScore API on ReefAPI returns SofaScore match statistics, lineups with ratings, heatmaps, shotmaps, player and team season stats, transfers, squads, league tables and rankings as JSON, with no SofaScore account. Call POST /sofascore/v1/<action>; start with entity_search to turn a name into a SofaScore id.
How do I find a player's or team's SofaScore id?▾
Call entity_search with the name. On 2026-11-21 "Haaland" returned 18 results with type, id, name, slug and country; the first was Erling Haaland, player 839956, Norway. team_squad also lists every player of a club with their ids.
Can I get xG and season statistics for a player?▾
Yes, with player_season_stats (player_id and league). For Erling Haaland in the Premier League on 2026-11-21 it returned 139 fields: 9 goals, 0 assists, 11 appearances, 980 minutes, expected goals 8.09, expected assists 0.91, 42 shots, 19 on target, 64.4% pass accuracy and a 7.55 average rating. type picks overall, home or away.
Does it return match statistics, lineups and heatmaps?▾
Yes. match_statistics returns possession, shots, xG and the other stat groups per period; match_lineups both formations with every player's rating, minutes and goals and the missing players; match_momentum the attack-momentum graph by minute; match_incidents the goal, card and substitution timeline; match_player_heatmap and match_player_shotmap one player's touches and shots with xG. Each takes a SofaScore match id.
Can I get transfers and market values?▾
player_transfers returns a player's transfer history (from club, to club, fee, date); team_transfers a club's arrivals and departures; player the profile with position, market value, preferred foot, height and contract.
Which competitions does it cover?▾
League keys such as eng.1 (Premier League), esp.1 (La Liga), ita.1 (Serie A), ger.1 (Bundesliga), fra.1 (Ligue 1) and uefa.champions resolve to SofaScore competitions (eng.1 was measured on 2026-11-21), and the league parameter also accepts a SofaScore tournament id or a competition name to search. rankings returns the FIFA men's ranking or the ATP or WTA tennis ranking.
Are SofaScore ids the same as ESPN ids?▾
No. Players, teams and matches each have their own SofaScore numbers (Haaland 839956). The ESPN API uses ESPN's ids, so look a team up again with entity_search when moving between the two.
Do old sports-data calls still work?▾
Yes. Calls to POST /sports-data/v1/<action> keep working unchanged with the same parameters and the same answer. The SofaScore actions now have their own name, POST /sofascore/v1/<action>; the ESPN actions are at POST /espn/v1/<action>.
What is the SofaScore API?▾
SofaScore API is a ReefAPI endpoint group for sofascore match statistics, lineups with player ratings, momentum, heatmaps and shotmaps, player and team season stats, transfers, squads, league tables, team of the week and world rankings, as json. It returns live JSON through POST requests under /sofascore/v1.
Is the SofaScore API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. SofaScore calls use the same shared credit balance as every other ReefAPI engine.
Do I need a SofaScore login or account?▾
No login to SofaScore is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the SofaScore data?▾
The page example is captured from a live entity_search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the SofaScore API use?▾
SofaScore actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call SofaScore from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call sofascore actions with the same key, credit pool and JSON envelope used by normal REST requests.
47 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling SofaScore, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.