SofaScore API

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
38 active endpoints, on 1 and 2 credit tiers.+28 more, every parameter ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

A name to SofaScore ids: players, teams, competitions, managers, referees

1 credit1 required · 0 optional
POST/sofascore/v1/entity_search
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    search players/teams/tournaments/managers/referees → SofaScore ids.

    required
    query
    optional
    —
  • live_events

    1 cr

    all in-play events for a sport.

    required
    sport
    optional
    —
  • scheduled_events

    1 cr

    all scheduled events for a sport on a date.

    required
    sport, date
    optional
    —
  • tournament_seasons

    1 cr

    Every season available for a competition (season id + year).

    required
    league
    optional
    —
  • match_statistics

    2 cr

    detailed match stats (possession/shots/xG).

    required
    event_id
    optional
    —
  • match_lineups

    2 cr

    lineups + per-player ratings & stats.

    required
    event_id
    optional
    —
  • match_momentum

    1 cr

    attack-momentum graph.

    required
    event_id
    optional
    —
  • match_incidents

    1 cr

    goal/card/sub timeline.

    required
    event_id
    optional
    —
  • match_best_players

    1 cr

    best player per team.

    required
    event_id
    optional
    —
  • match_h2h

    1 cr

    head-to-head duel record.

    required
    event_id
    optional
    —
  • match_managers

    1 cr

    both managers for a match.

    required
    event_id
    optional
    —
  • match_odds

    2 cr

    multi-market odds for a match.

    required
    event_id
    optional
    —
  • match_player_heatmap

    1 cr

    a player's touch heatmap in a match.

    required
    event_id, player_id
    optional
    —
  • match_player_shotmap

    1 cr

    a player's shotmap in a match.

    required
    event_id, player_id
    optional
    —
  • match_average_positions

    1 cr

    average player positions on the pitch.

    required
    event_id
    optional
    —
  • player

    1 cr

    Player profile.

    required
    player_id
    optional
    —
  • player_season_stats

    2 cr

    player's season statistics in a league.

    required
    player_id, league
    optional
    season, type
  • player_heatmap

    1 cr

    player's season heatmap.

    required
    player_id, league
    optional
    season
  • player_attributes

    1 cr

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

    required
    player_id
    optional
    —
  • player_transfers

    1 cr

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

    required
    player_id
    optional
    —
  • player_recent

    1 cr

    player's recent matches.

    required
    player_id
    optional
    —
  • team_details

    1 cr

    Team profile.

    required
    team_id
    optional
    —
  • team_squad

    1 cr

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

    required
    team_id
    optional
    —
  • team_transfers

    1 cr

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

    required
    team_id
    optional
    —
  • team_season_stats

    2 cr

    team's season statistics in a league.

    required
    team_id, league
    optional
    season, type
  • team_form

    1 cr

    team recent form + next/prev event.

    required
    team_id
    optional
    —
  • team_goal_distributions

    1 cr

    goals scored/conceded by match period.

    required
    team_id, league
    optional
    season
  • season_standings

    2 cr

    SofaScore league table for a competition (overall / home / away splits) with goals for/agains…

    required
    league
    optional
    season, type
  • season_top_players

    2 cr

    season leaders by category.

    required
    league
    optional
    season, type
  • season_top_teams

    2 cr

    season top teams by category.

    required
    league
    optional
    season, type
  • team_of_week

    2 cr

    team of the week (round or rounds list).

    required
    league
    optional
    season, round_id
  • power_rankings

    2 cr

    season power rankings.

    required
    league
    optional
    season, round_id
  • cup_tree

    2 cr

    knockout bracket / cup tree.

    required
    league
    optional
    season
  • tournament_details

    1 cr

    Competition metadata.

    required
    league
    optional
    —
  • manager

    1 cr

    Manager profile and full club-by-club career history (matches, wins, points) by SofaScore man…

    required
    manager_id
    optional
    —
  • referee

    1 cr

    referee details + per-tournament stats.

    required
    referee_id
    optional
    —
  • rankings

    1 cr

    World rankings.

    required
    —
    optional
    type
  • leagues

    1 cr

    Directory 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 it works

How the SofaScore API works

SofaScore is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /sofascore/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a player's name to a full season profile

Find the SofaScore id, read the season statistics, then the profile, transfers and heatmap.

01entity_search
POST/sofascore/v1/entity_search
{"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.

02player_season_stats
POST/sofascore/v1/player_season_stats
{"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.

03player_transfers
POST/sofascore/v1/player_transfers
{"player_id": "839956"}

Every transfer with the clubs, fee and date; player returns the profile with position, market value, preferred foot, height and contract.

04player_heatmap
POST/sofascore/v1/player_heatmap
{"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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "sofascore",
    "endpoint": "entity_search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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 inputWhat 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_idSofaScore'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.
leagueA 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_idseason 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 statistics139 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 statsoverall, home or away split. Other SofaScore split names are passed on; a wrong one returns NOT_FOUND.
rankings typefifa (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.

Coverage

SofaScore coverage, measured

Numbers below come from live calls on 2026-11-21; ids are SofaScore's own.

Actions

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.

Search

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

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.

Competitions

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.

Limits

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.

Use cases

What people build with SofaScore

The jobs this data is most often used for.

01

Build player scouting profiles from season statistics, xG, attribute radars and heatmaps.

02

Show match centres with statistics, lineups with ratings, momentum and the incident timeline.

03

Track transfers and market values of players and clubs.

04

Feed fantasy football and prediction models with per-player season data.

38

endpoints

1/2

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.