SofaScore
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.
/sofascore/v1/entity_search1 creditsearch players/teams/tournaments/managers/referees → SofaScore ids
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text for a team/player/tournament/manager/referee. |
/sofascore/v1/live_events1 creditall in-play events for a sport
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport = football | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
/sofascore/v1/scheduled_events1 creditall scheduled events for a sport on a date
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport = football | required | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
| date | required | — | Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live. |
/sofascore/v1/tournament_seasons1 creditEvery season available for a competition (season id + year) — use the id to scope season-specific calls.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
/sofascore/v1/match_statistics2 creditsdetailed match stats (possession/shots/xG)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_lineups2 creditslineups + per-player ratings & stats
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_momentum1 creditattack-momentum graph
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_incidents1 creditgoal/card/sub timeline
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_best_players1 creditbest player per team
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_h2h1 credithead-to-head duel record
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_managers1 creditboth managers for a match
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_odds2 creditsmulti-market odds for a match
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/match_player_heatmap1 credita player's touch heatmap in a match
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/match_player_shotmap1 credita player's shotmap in a match
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/match_average_positions1 creditaverage player positions on the pitch
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| event_id | required | — | ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league. |
/sofascore/v1/player1 creditPlayer profile: current team, position, market value, preferred foot, height, date of birth and contract — by SofaScore player id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/player_season_stats2 creditsplayer's season statistics in a league
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| type = overall | optional | overall · home · away | Stat split. Other SofaScore split keys are accepted but a wrong one 404s. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/player_heatmap1 creditplayer's season heatmap
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/player_attributes1 creditplayer attribute radar (att/tech/tac/def/cre)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/player_transfers1 creditA player's full transfer history (from/to club, fee, date) by SofaScore player id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/player_recent1 creditplayer's recent matches
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| player_id | required | — | SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result. |
/sofascore/v1/team_details1 creditTeam profile: manager, venue, founding year and recent pregame form — by SofaScore team id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
/sofascore/v1/team_squad1 creditA club's full current squad (every player with id, position, value) by SofaScore team id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
/sofascore/v1/team_transfers1 creditA club's transfers in and out (player, club, fee, date) by SofaScore team id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
/sofascore/v1/team_season_stats2 creditsteam's season statistics in a league
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| type = overall | optional | overall · home · away | Stat split. Other SofaScore split keys are accepted but a wrong one 404s. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/team_form1 creditteam recent form + next/prev event
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
/sofascore/v1/team_goal_distributions1 creditgoals scored/conceded by match period
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| team_id | required | — | SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL. |
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/season_standings2 creditsSofaScore league table for a competition (overall / home / away splits) with goals for/against and goal difference.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| type = total | optional | total · home · away | Which standings table to return. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/season_top_players2 creditsseason leaders by category
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| type = overall | optional | overall · home · away | Split for the season leaders. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/season_top_teams2 creditsseason top teams by category
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| type = overall | optional | overall · home · away | Split for the season leaders. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/team_of_week2 creditsteam of the week (round or rounds list)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| round_id | optional | — | Specific round id; omit to list the available rounds. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/power_rankings2 creditsseason power rankings
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| round_id | optional | — | Specific round id; omit to list the available rounds. |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/cup_tree2 creditsknockout bracket / cup tree
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
| season | optional | — | Season year (soccer standings need it; default current season). |
| season_id | optional | — | Explicit SofaScore season id (skips season resolution). |
/sofascore/v1/tournament_details1 creditCompetition metadata: country, tier, and the clubs with the most titles — by league key.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| league | required | — | League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id. |
/sofascore/v1/manager1 creditManager profile and full club-by-club career history (matches, wins, points) by SofaScore manager id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| manager_id | required | — | SofaScore manager id (from entity_search). |
/sofascore/v1/referee1 creditreferee details + per-tournament stats
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| referee_id | required | — | SofaScore referee id (from entity_search). |
/sofascore/v1/rankings1 creditWorld rankings — FIFA men's football, or ATP / WTA tennis (set type; defaults to FIFA).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| type = fifa | optional | fifa · atp · wta | Which world ranking to return. Closed set: fifa, atp, wta (a wrong value returns INVALID_PARAM). |
/sofascore/v1/leagues1 creditDirectory of every supported league/competition (key, name, sport) — call this first to discover the league keys the other actions take.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| sport | optional | baseball · basketball · cricket · football · hockey · soccer · tennis | Sport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own. |
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": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.