Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the SofaScore API page →
docs / sofascore

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.

base /sofascore/v138 endpoints
post/sofascore/v1/live_events1 credit

all in-play events for a sport

ParameterAllowed / rangeDescription
sport = footballrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
Try in playground →
post/sofascore/v1/scheduled_events1 credit

all scheduled events for a sport on a date

ParameterAllowed / rangeDescription
sport = footballrequiredbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
daterequired—Date filter, ESPN format YYYYMMDD (or a range 'YYYYMMDD-YYYYMMDD'). Omit for today / live.
Try in playground →
post/sofascore/v1/tournament_seasons1 credit

Every season available for a competition (season id + year) — use the id to scope season-specific calls.

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
Try in playground →
post/sofascore/v1/match_statistics2 credits

detailed match stats (possession/shots/xG)

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_lineups2 credits

lineups + per-player ratings & stats

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_momentum1 credit

attack-momentum graph

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_incidents1 credit

goal/card/sub timeline

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_best_players1 credit

best player per team

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_h2h1 credit

head-to-head duel record

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_managers1 credit

both managers for a match

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_odds2 credits

multi-market odds for a match

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/match_player_heatmap1 credit

a player's touch heatmap in a match

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/match_player_shotmap1 credit

a player's shotmap in a match

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/match_average_positions1 credit

average player positions on the pitch

ParameterAllowed / rangeDescription
event_idrequired—ESPN event/game id — take it from the `event_id` of any scores, fixtures or team_schedule result for the same sport/league.
Try in playground →
post/sofascore/v1/player1 credit

Player profile: current team, position, market value, preferred foot, height, date of birth and contract — by SofaScore player id.

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/player_season_stats2 credits

player's season statistics in a league

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
type = overalloptionaloverall · home · awayStat split. Other SofaScore split keys are accepted but a wrong one 404s.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/player_heatmap1 credit

player's season heatmap

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/player_attributes1 credit

player attribute radar (att/tech/tac/def/cre)

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/player_transfers1 credit

A player's full transfer history (from/to club, fee, date) by SofaScore player id.

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/player_recent1 credit

player's recent matches

ParameterAllowed / rangeDescription
player_idrequired—SofaScore player id (e.g. 839956 = Erling Haaland). Resolve unknown players from a SofaScore player URL or a team_squad result.
Try in playground →
post/sofascore/v1/team_details1 credit

Team profile: manager, venue, founding year and recent pregame form — by SofaScore team id.

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
Try in playground →
post/sofascore/v1/team_squad1 credit

A club's full current squad (every player with id, position, value) by SofaScore team id.

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
Try in playground →
post/sofascore/v1/team_transfers1 credit

A club's transfers in and out (player, club, fee, date) by SofaScore team id.

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
Try in playground →
post/sofascore/v1/team_season_stats2 credits

team's season statistics in a league

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
type = overalloptionaloverall · home · awayStat split. Other SofaScore split keys are accepted but a wrong one 404s.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/team_form1 credit

team recent form + next/prev event

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
Try in playground →
post/sofascore/v1/team_goal_distributions1 credit

goals scored/conceded by match period

ParameterAllowed / rangeDescription
team_idrequired—SofaScore team id (NOT the ESPN id) — e.g. 17 = Manchester City, 42 = Arsenal. Resolve unknown teams via a SofaScore team URL.
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/season_standings2 credits

SofaScore league table for a competition (overall / home / away splits) with goals for/against and goal difference.

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
type = totaloptionaltotal · home · awayWhich standings table to return.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/season_top_players2 credits

season leaders by category

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
type = overalloptionaloverall · home · awaySplit for the season leaders.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/season_top_teams2 credits

season top teams by category

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
type = overalloptionaloverall · home · awaySplit for the season leaders.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/team_of_week2 credits

team of the week (round or rounds list)

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
round_idoptional—Specific round id; omit to list the available rounds.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/power_rankings2 credits

season power rankings

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
round_idoptional—Specific round id; omit to list the available rounds.
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/cup_tree2 credits

knockout bracket / cup tree

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
seasonoptional—Season year (soccer standings need it; default current season).
season_idoptional—Explicit SofaScore season id (skips season resolution).
Try in playground →
post/sofascore/v1/tournament_details1 credit

Competition metadata: country, tier, and the clubs with the most titles — by league key.

ParameterAllowed / rangeDescription
leaguerequired—League key (e.g. 'eng.1', 'nba'), a raw name to search, or a SofaScore numeric unique-tournament id.
Try in playground →
post/sofascore/v1/manager1 credit

Manager profile and full club-by-club career history (matches, wins, points) by SofaScore manager id.

ParameterAllowed / rangeDescription
manager_idrequired—SofaScore manager id (from entity_search).
Try in playground →
post/sofascore/v1/referee1 credit

referee details + per-tournament stats

ParameterAllowed / rangeDescription
referee_idrequired—SofaScore referee id (from entity_search).
Try in playground →
post/sofascore/v1/rankings1 credit

World rankings — FIFA men's football, or ATP / WTA tennis (set type; defaults to FIFA).

ParameterAllowed / rangeDescription
type = fifaoptionalfifa · atp · wtaWhich world ranking to return. Closed set: fifa, atp, wta (a wrong value returns INVALID_PARAM).
Try in playground →
post/sofascore/v1/leagues1 credit

Directory of every supported league/competition (key, name, sport) — call this first to discover the league keys the other actions take.

ParameterAllowed / rangeDescription
sportoptionalbaseball · basketball · cricket · football · hockey · soccer · tennisSport family (ESPN path). Required with a raw league segment; a known league key (e.g. 'nba') can resolve the sport on its own.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.