This page outlines the comprehensive fantasy statistics dataset for players available through our **football API**. Developers integrating the **football API** will find detailed documentation covering every metric and field returned for player fantasy pe
This football API endpoint returns match data exclusively for fixtures that have already concluded. A match may therefore appear either within the live score football API carrying a status of
FINISHED, or inside the history matches dataset.This football API endpoint delivers data across multiple languages. Translated fields include competition names, team names, and player names. For further details consult our documentation on language support.
ENDPOINT
The fantasy players statistics endpoint within our football API offers considerable power and flexibility. A wide range of parameters lets developers filter results in numerous ways, making it straightforward to retrieve precisely the information required.
GET:
Check this Football API endpoint in our postman collection. Download it now!
Parameters
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| competition_id | number | 3 | To narrow the returned statistics to a single competition only, apply this parameter. | |
| match_id | number | 702913 | The id of the match whose fantasy player stats you wish to retrieve. | |
| opponent_team_id | number | 26 | To pull player statistics recorded against a particular opponent team, use this parameter. | |
| player_id | number | 9559 | To retrieve stats for one specific player exclusively, pass this parameter. | |
| team_id | number | 21 | To fetch fantasy player statistics for matches belonging to a specific team, supply this parameter. |
The
opponent_team_id parameter functions solely when paired with either the player_id or the team_id.Pairing these parameters together unlocks a broad spectrum of filtering possibilities, letting developers shape the returned data around even the most granular requirement. The supported combinations are listed below.
Team-Based Queries
| team_id | opponent_team_id | competition_id | Description |
|---|---|---|---|
| ✔ | ❌ | ❌ | Every fantasy record tied to one team across all competitions. Example: every Liverpool fixture |
| ✔ | ✔ | ❌ | One team facing a chosen opponent across all competitions. Example: every Liverpool vs Everton meeting |
| ✔ | ✔ | ✔ | Two sides squaring off inside a single competition. Example: Real vs Barca in Copa Del Rey |
| ✔ | ❌ | ✔ | A single team's fantasy player stats confined to one competition. Example: PSG in Ligue 1 |
Player-Based Queries
| player_id | team_id | opponent_team_id | competition_id | Description |
|---|---|---|---|---|
| ✔ | ❌ | ❌ | ❌ | Every record tied to one player. Example: all fantasy data for Robert Lewandowski |
| ✔ | ❌ | ✔ | ❌ | One player facing a chosen opponent. Example: every match of Robert Lewandowski versus Atletico de Madrid. This spans his appearances as a Bayern Munchen player and as a Barcelona player across all Spanish competitions and the UEFA Champions League. |
| ✔ | ✔ | ✔ | ❌ | One player representing a team across all competitions. Example: Mason Mount against Liverpool while playing for Manchester United |
| ✔ | ❌ | ❌ | ✔ | One player inside a single competition. Example: Lewandowski in the UEFA Champions League. |
| ✔ | ✔ | ❌ | ❌ | One player representing a team across all competitions. Example: Ronaldo for Portugal covers matches from the EURO, World Cup, Friendlies, and Qualifiers. |
| ✔ | ✔ | ❌ | ✔ | One player representing a team inside a single competition. Example: Messi for Argentina in the World Cup |
| ✔ | ❌ | ✔ | ✔ | One player facing a chosen opponent inside a competition. Example: Lewandowski against Juventus in the UEFA Champions League |
| ✔ | ✔ | ✔ | ✔ | One player representing a team against a chosen opponent inside a competition. Example: Antoine Griezmann against Real Madrid while playing for Atletico in La Liga |
Match-Based Queries
| match_id | player_id | Description |
|---|---|---|
| ✔ | ❌ | Every player's fantasy data for one match |
| ✔ | ✔ | One player's fantasy data within one match |
Response
Within the sample response below, only three players appear so that space and time are conserved. Once you invoke the fantasy football API endpoint, statistics are returned for every player who took part in the match.
{
"success": true,
"data": [
{
"competition": {
"id": 244,
"name": "Champions League"
},
"stats": [
{
"name": "Jonathan Tah",
"photo": "https:\/\/cdn.football-api.com\/players\/8\/0\/6\/f\/806fec5af7f5b48b8a31a003e171f3fb.png",
"id": 2337,
"stats": {
"clearances": 2,
"minutes_played": 90,
"ground_duels_won": 0,
"dispossessed": 0,
"chances_created": 0,
"ground_duels_total": 1,
"ball_touches_opposition_box_total": 0,
"aerials_duels_won": 0,
"headed_clearance": 1,
"duels_lost_total": 1,
"long_balls_total": 1,
"ball_touches_total": 45,
"passes_completed": 41,
"defensive_actions": 3,
"fouls_committed": 0,
"aerials_duels_total": 0,
"recoveries": 3,
"interceptions": 0,
"tackles_total": 0,
"blocked_opposition_shots": 1,
"assists": 0,
"goals_scored": 0,
"passes_attempted": 41,
"dribbled_past": 1,
"long_balls_accurate": 1,
"passes_into_final_third": 3
},
"team_id": 46
},
{
"name": "Manuel Neuer",
"photo": "https:\/\/cdn.football-api.com\/players\/4\/e\/b\/d\/4ebd440d99504722d80de606ea8507da.png",
"id": 2360,
"stats": {
"clearances": 1,
"keeper_high_claim": 0,
"minutes_played": 90,
"keep_player_throws": 5,
"keeper_sweeper": 1,
"keeper_saves_inside_box": 1,
"long_balls_total": 12,
"keeper_saves_total": 2,
"defensive_actions": 1,
"ball_touches_total": 31,
"keeper_punches": 0,
"passes_completed": 14,
"goals_due_to_errors": 1,
"goals_conceded_total": 3,
"fouls_committed": 0,
"recoveries": 7,
"interceptions": 0,
"tackles_total": 0,
"keeper_diving_save": 1,
"passes_attempted": 23,
"long_balls_accurate": 4,
"passes_into_final_third": 4
},
"team_id": 46
},
{
"name": "Joshua Kimmich",
"photo": "https:\/\/cdn.football-api.com\/players\/3\/0\/0\/8\/300891a62162b960cf02ce3827bb363c.png",
"id": 2367,
"stats": {
"clearances": 0,
"minutes_played": 90,
"ground_duels_won": 4,
"dispossessed": 0,
"shots_on_target": 1,
"ground_duels_total": 4,
"ball_touches_opposition_box_total": 2,
"aerials_duels_won": 1,
"long_balls_total": 10,
"ball_touches_total": 136,
"passes_completed": 102,
"shots_off_target": 0,
"corners": 6,
"defensive_actions": 6,
"crosses_total": 6,
"fouls_committed": 0,
"aerials_duels_total": 1,
"recoveries": 3,
"interceptions": 2,
"chances_created": 4,
"tackles_total": 4,
"blocked_opposition_shots": 0,
"assists": 1,
"crosses_completed": 4,
"shots_blocked": 1,
"big_chances_created": 1,
"duels_won_total": 5,
"goals_scored": 0,
"passes_attempted": 118,
"dribbled_past": 0,
"long_balls_accurate": 8,
"passes_into_final_third": 16
},
"team_id": 46
}
],
"match": {
"time": "FT",
"year": "2026",
"home": {
"logo": "https:\/\/cdn.football-api.com\/teams\/46.png",
"id": 46,
"name": "Bayern Munich",
"country_id": 1,
"stadium": "Allianz Arena"
},
"ps_score": "",
"id": 702913,
"away": {
"logo": "https:\/\/cdn.football-api.com\/teams\/27.png",
"id": 27,
"name": "Real Madrid",
"country_id": 43,
"stadium": "Estadio Santiago Bernab\u00e9u"
},
"et_score": "",
"status": "FINISHED",
"ht_score": "2 - 3",
"score": "4 - 3",
"location": "Allianz Arena",
"ft_score": "4 - 3"
}
}
]
}Getting Translated Data
To retrieve fantasy player statistics for a single match, supply the match_id of that match as a GET parameter inside the football API endpoint URL. The optional lang parameter lets you request translated data. The examples below show how to fetch fantasy data for the match with match_id 702913 in Russian.
cUrl:
curl -XGET "https://api.football-api.com/fantasy/fantasy.json?key=demo_key&secret=demo_secret&match_id=702913&lang=ru"file_get_contents('https://api.football-api.com/fantasy/fantasy.json?key=demo_key\&secret=demo_secret\&match_id=702913\&lang=ru');import urllib2
req = urllib2.Request('https://api.football-api.com/fantasy/fantasy.json?key=demo_key\&secret=demo_secret\&match_id=702913\&lang=ru')
response = urllib2.urlopen(req)
print response.read()