SofaScore API (sofascore.com): Real-Time Scores, Results & Match Stats. Get detailed sports data including live scores, fixtures, results, and stats from SofaScore across football (soccer), tennis, basketball, hockey and more.
Returns a list of all categories (countries/regions) for a given sport.
Returns a list of unique tournaments for a given category.
Returns the country flag image bytes for a two-letter ISO country code. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns a list of all available sports.
Returns the manager photo image bytes. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns the AI generated pre-match preview, predictions and half-time analysis for a specific match. Available only after the match has finished.
Returns the best rated players for each team and the player of the match for a specific match.
Returns comments for a specific match.
Returns detailed information about a specific match.
Returns the head-to-head summary (team and manager duel records) and the previous meetings between the two teams of a specific match.
Returns the general and head-to-head streaks (goals, cards, corners, form) of both teams of a specific match.
Returns video highlights for a specific match.
Returns incidents (goals, cards, substitutions, periods, VAR, injury time) for a specific match.
Returns lineups for a specific match.
Returns a list of matches for a specific date, filtered by sport. Only football, tennis and basketball are supported. For every other match based sport use /v1/match/scheduled-tournaments to list the tournaments played on a date, then /v1/match/scheduled to list the matches of each tournament. Motorsport and cycling are not organised into matches at all - use /v1/stage/scheduled instead.
Returns a list of all currently live matches, filtered by sport.
Returns the home and away team managers for a specific match.
Returns odds for a specific match.
Returns the featured full-time 1X2 odds of every match played on a specific date, filtered by sport and odds provider. Every item carries the SofaScore match ID, so the odds can be joined with /v1/match/list or /v1/match/details. Use /v1/match/odds for every market of a single match.
Returns a list of odds providers for the given country and platform.
Returns official tweets (posts from the participating teams' verified accounts) for a specific match.
Returns the average pitch position (averageX/averageY) of each player per team, along with the match substitutions, for a specific match.
Returns the player of the match voting for a specific match, with every candidate and their votes.
Returns point-by-point breakdown for a tennis match (sets, games, points, and per-game serving info).
Returns the pre-match form (recent results, average rating, league position and points) for both teams of a specific match.
Returns a list of scheduled matches for a specific unique tournament on a specific date. Use /v1/match/scheduled-tournaments first to get the tournaments played on that date.
Returns a list of unique-tournaments with scheduled matches for a specific date. Works for every sport. Pair it with /v1/match/scheduled to fetch the matches of each tournament.
Returns the shotmap (every shot with its player, coordinates, body part, situation and xG) for a specific match.
Returns statistics for a specific match.
Returns voting information for a specific match.
Returns the attribute overviews (attacking, technical, tactical, defending, creativity) for a specific player, alongside the position average.
Returns a player full career statistics
Returns the competitions (unique tournaments) a player has taken part in.
Returns detailed information about a specific player.
Returns the player photo image bytes. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns finished matches for a specific player, paginated.
Returns a player's national team statistics (appearances, goals, debut) per national team.
Returns a player's season statistics for a specific league (unique tournament) and season.
Returns the leagues (unique tournaments) a player has season statistics for, each with the list of available seasons (years).
Returns transfer history for a specific player.
Search all SofaScore entities by query string.
Search SofaScore managers by query string.
Search SofaScore matches by query string.
Search SofaScore players by query string.
Search SofaScore referees by query string.
Search SofaScore teams by query string.
Search SofaScore unique tournaments by query string.
Search SofaScore venues by query string.
Returns detailed information about a specific stage, which can be a season, a race weekend or a single session such as practice, qualifying or the race itself.
Returns the unique stage (racing series) logo image bytes. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns the races scheduled around a specific date, filtered by sport. Only motorsport and cycling are organised into stages; every other sport is organised into matches, so use /v1/match/list or /v1/match/scheduled-tournaments instead.
Returns the seasons of a given unique stage (racing series).
Returns the competitor standings of a specific stage: the classification of a single race, or the drivers and riders championship of a season.
Returns the team standings of a specific stage, such as the constructors championship of a season.
Returns the substages of a specific stage: the races of a season, or the sessions of a race weekend such as practice, qualifying and the race itself.
Returns the unique stages (racing series such as Formula 1, MotoGP or IndyCar) of a given category.
Returns detailed information about a specific team.
Returns the team crest image bytes. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns finished matches for a specific team, paginated.
Returns upcoming matches for a specific team, paginated.
Returns media videos for a specific team.
Returns players for a specific team.
Returns statistics for a specific team in a given unique tournament season.
Returns the leagues (unique tournaments) a team has season statistics for, each with the list of available seasons (years).
Returns top players for a specific team.
Returns details for a specific unique tournament.
Returns the competition (unique tournament) logo image bytes. If the image does not exist, a neutral placeholder is returned instead of an error.
Returns a list of unique-tournament with scheduled matches for a specific date.
Returns a list of scheduled matches for a specific unique tournament on a specific date.
Returns cup trees for a specific season in a unique tournament.
Returns details for a specific season in a unique tournament.
Returns finished matches for a specific season in a unique tournament, paginated.
Returns upcoming matches for a specific season in a unique tournament, paginated.
Returns matches for a specific round in a season of a unique tournament.
Returns rounds for a specific season in a unique tournament.
Returns standings for a specific season in a unique tournament.
Returns top players stats for a specific season in a unique tournament.
Returns top teams stats for a specific season in a unique tournament.
Returns seasons for a specific unique tournament.
Easiest way: the APIHub CLI. Credits cover x402, no wallet needed.
# install and set up once
npx @apihubio/cli register
npx @apihubio/cli topup 10
# call this service
npx @apihubio/cli call -X GET "https://proxy.apihub.io/sofascore/v1/category/list?sport_slug=football"Or call the proxy directly (curl / any HTTP client):
curl https://proxy.apihub.io/sofascore/v1/category/list?sport_slug=football \
-H "Authorization: Bearer ahk_your_key"
# If credits available: charged automatically, returns 200
# Otherwise: returns 402 (pay via @x402/fetch or top up credits)Estimate your monthly cost for SofaScore.