Flashscore match player statistics API

Endpoint facts

Method

GET

API path

/flashscore/match-player-stats

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

Flashscore

Response schema

#/definitions/flashscore.matchPlayerStatsResponseDoc

How this endpoint behaves

Query parameters:

• id (required): eight-character football match id from a Flashscore match URL, for example j52jHsN8.
• player_id (optional): eight-character Flashscore player id of a player in this match (the id of an entry in players, or a player id from the lineups). Returns only that player, which is far smaller than the full response. An id that is not part of the match returns 404.
• group (optional): narrows the statistics to one tab of the player-statistics page. One of top_stats, shots, attack, passes, defense, goalkeeping, general. Letter case is ignored; any other value is rejected with 400 before a request is made. Omit it to return every group.

Returns per-player football statistics for matches with player-statistics coverage. The full response covers about 40 players with roughly 60 statistics each, so prefer group or player_id when you only need part of it.

• teams: id, name and side (home or away).
• groups: the statistic groups returned (key is one of the group values above, label, goalkeeper_only and the member stats keys). The groups were read from three football matches (Premier League, Argentine Liga Profesional, Spanish LaLiga2) and were identical in all three.
• stat_types: the definition of every returned statistic: key (lowercase, for example shots_total, expected_goals, passes_accurate), label, format (count, percentage or count_two_decimal_places), sentiment (positive when a higher value is good, negative otherwise) and the groups it belongs to. combined is set where Flashscore prints a statistic with its total and share, for example 25/32 (78.13%): template is %s/%s (%s) and stats lists the three keys to fill it with, so those totals and shares are included even though they belong to no group. fs_rating is the group entry for the rating, which is returned in each player's rating field instead of in stats.
• players: id, name, short_name, slug, team_id, side (home or away), position (for example Goalkeeper, Centre back, Midfielder, Striker; the list is the provider's own and not closed), starter, rating, top_rated, highlights and stats.
• rating is the Flashscore match rating, or null for players who did not play. top_rated is true for the highest-rated player of the match; it is the rating leader and can differ from the editorial man of the match named in /api/v1/flashscore/match-report.
• highlights are the badges shown beside a player, lowercase: for example goals, assists, winning_goal, big_chances_created, big_chances_missed, big_chances_saved, clean_sheet, goals_conceded, errors_leading_to_shot, dueling_negative, last_man_tackles, finishing_positive, dribbling, hit_the_woodwork, passing and shot_stopping. These are the values seen in one match; the provider may add others.
• stats maps a stat_types key to {"value", "raw", "rank"}: value is the displayed text (0.11, 78.12%), raw the unrounded number (a share runs from 0 to 1) and rank the player's position among all players of the match for that statistic (omitted when the provider gives none).

Matches without player-statistics coverage, matches of other sports and unknown ids return 404.

Example response (shortened, with group=shots and player_id=trpxfbO3):

{"code":200,"msg":"OK","data":{"source_url":"https://2.ds.lsapp.eu/pq_graphql?_hash=epmsdp&eventId=j52jHsN8&playerId=trpxfbO3&providerId=7","match_id":"j52jHsN8","teams":[{"id":"2XrRecc3","name":"Brighton","side":"home"},{"id":"hA1Zm19f","name":"Arsenal","side":"away"}],"groups":[{"key":"shots","label":"Shots","goalkeeper_only":false,"stats":["shots_total","goals","expected_goals"]}],"stat_types":[{"key":"shots_total","label":"Total shots","format":"count","sentiment":"positive","groups":["shots"]}],"players":[{"id":"trpxfbO3","name":"Gross Pascal","slug":"gross-pascal","team_id":"2XrRecc3","side":"home","position":"Midfielder","starter":true,"rating":8.3,"top_rated":true,"highlights":["goals","winning_goal","assists","big_chances_created"],"stats":{"shots_total":{"value":"2","raw":2,"rank":2},"expected_goals":{"value":"0.11","raw":0.1074,"rank":9}}}]}}

Live monitoring

Monitored request

GET /flashscore/match-player-stats?group=top_stats&id=j52jHsN8

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

5.42 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /flashscore/match-player-stats?group=top_stats&id=j52jHsN8

Items in players

40

Fields filled in every checked item

10

Fields empty in some or all items

2

Shared guides

Related