📊 Overview

Our API provides enterprise-grade soccer statistics covering:

Category	Stat Count	Coverage
Match Stats	150+ metrics	Team-level performance
Player Stats	120+ metrics	Individual performance
Market Stats	25+ metrics	Betting-relevant data
Temporal Data	By period	Full match + half-by-half

🏟️ Sample Match Reference

All examples in this guide are from:

Brentford FC 3-1 Burnley FC
Premier League | Matchweek 13
November 29, 2025 | Brentford Community Stadium
Attendance: 17,176

📁 Match Statistics Endpoint

Fixture Metadata

Every match includes rich contextual data:

{
  "fixture": {
    "id": "202511295169F9DF",
    "game_id": "31803-20560-2025-11-29",
    "start_date": "2025-11-29T15:00:00Z",
    "status": "completed",
    "season_type": "Regular Season",
    "season_year": "2025",
    "season_week": "13",
    "venue_name": "Brentford Community Stadium",
    "venue_location": "London, England",
    "venue_neutral": false
  }
}

Score Data

Granular scoring breakdown by period:

{
  "scores": {
    "home": {
      "total": 3.0,
      "periods": {
        "period_1": 0.0,
        "period_2": 3.0
      }
    },
    "away": {
      "total": 1.0,
      "periods": {
        "period_1": 0.0,
        "period_2": 1.0
      }
    }
  }
}

📈 Team Statistics Categories

1. Possession & Passing

Statistic	Brentford	Burnley	Description
`possession_percentage`	52.1%	47.9%	Ball possession
`total_pass`	406	379	Total passes attempted
`accurate_pass`	321	263	Successful passes
`fwd_pass`	151	144	Forward passes
`backward_pass`	56	58	Backward passes
`total_long_balls`	42	79	Long ball attempts
`accurate_long_balls`	19	20	Successful long balls
`total_through_ball`	3	1	Through ball attempts
`total_cross`	24	15	Crossing attempts
`accurate_cross`	5	1	Successful crosses

Zonal Passing Breakdown:

leftside_pass    → Passes on the left flank
rightside_pass   → Passes on the right flank
total_fwd_zone_pass  → Passes into forward zones
total_back_zone_pass → Passes into defensive zones
final_third_entries  → Ball progressions into final third

Real Example - Brentford:

{
  "leftside_pass": 94,
  "rightside_pass": 105,
  "total_fwd_zone_pass": 255,
  "accurate_fwd_zone_pass": 170,
  "final_third_entries": 71
}

2. Shooting & Chances

Statistic	Brentford	Burnley	Description
`total_scoring_att`	14	6	Total shots
`ontarget_scoring_att`	4	2	Shots on target
`shot_off_target`	9	1	Shots off target
`blocked_scoring_att`	1	3	Shots blocked
`big_chance_created`	3	0	Clear-cut chances created
`big_chance_scored`	3	1	Big chances converted
`big_chance_missed`	3	0	Big chances missed

Shot Location Breakdown:

attempts_ibox    → Shots inside the box
attempts_obox    → Shots outside the box
att_bx_centre    → Shots from central box area
att_obx_centre   → Shots from central area outside box

Shot Outcome Detail:

att_miss_high    → Shots missed high
att_miss_left    → Shots missed left
att_miss_right   → Shots missed right
att_goal_low_left   → Goals in bottom left
att_goal_low_centre → Goals in bottom center
att_goal_high_left  → Goals in top left

3. Defensive Statistics

Statistic	Brentford	Burnley	Description
`total_tackle`	9	26	Tackles attempted
`won_tackle`	8	18	Successful tackles
`interceptions`	11	7	Interceptions made
`total_clearance`	51	37	Clearances
`head_clearance`	39	25	Headed clearances
`blocked_pass`	11	8	Passes blocked
`ball_recovery`	58	44	Ball recoveries

Pressing Metrics:

{
  "ppda": 14.4,  // Passes per defensive action (Brentford)
  "ppda": 12.3,  // Burnley - lower = more pressing
  "defensive_actions": 22,
  "poss_won_att3rd": 8,  // Possessions won in attacking third
  "poss_won_mid3rd": 27, // Possessions won in middle third
  "poss_won_def3rd": 15  // Possessions won in defensive third
}

4. Aerial & Duels

Statistic	Brentford	Burnley	Description
`duel_won`	52	51	Duels won
`duel_lost`	51	52	Duels lost
`aerial_won`	30	16	Aerial duels won
`aerial_lost`	16	30	Aerial duels lost
`won_contest`	7	2	Contests won

5. Set Pieces & Corners

Statistic	Brentford	Burnley	Description
`att_corner`	3	2	Corner kicks taken
`corner_taken`	5	6	Corners delivered
`total_corners_intobox`	5	6	Corners into the box
`accurate_corners_intobox`	2	0	Successful corners
`won_corners`	5	6	Corners won
`lost_corners`	6	5	Corners conceded

6. Goalkeeper Statistics

{
  "saves": 1,
  "diving_save": 1,
  "saved_obox": 1,
  "good_high_claim": 1,
  "total_high_claim": 1,
  "total_keeper_sweeper": 1,
  "accurate_keeper_sweeper": 1,
  "keeper_throws": 6,
  "accurate_keeper_throws": 6,
  "goal_kicks": 1,
  "accurate_goal_kicks": 1
}

7. Discipline & Fouls

Statistic	Brentford	Burnley	Description
`fouls`	7	7	Fouls committed
`fk_foul_won`	6	7	Fouls won
`total_yellow_card`	0	2	Yellow cards
`penalty_won`	1	1	Penalties won
`penalty_conceded`	1	1	Penalties conceded
`penalty_faced`	1	1	Penalties faced

💰 Market Statistics (Betting Data)

Pre-calculated metrics for betting markets:

{
  "home": {
    "team_total": 3.0,
    "asian_team_total": 3.0,
    "team_total_cards": 0.0,
    "team_total_fouls": 7.0,
    "team_total_shots": 14.0,
    "team_total_corners": 5.0,
    "team_total_tackles": 9.0,
    "team_total_offsides": 3.0,
    "team_total_shots_on_target": 4.0,
    "1st_half_team_total": 0.0,
    "2nd_half_team_total": 3.0,
    "1st_half_team_total_corners": 2.0,
    "2nd_half_team_total_corners": 3.0
  }
}

👤 Player Statistics Endpoint

Player Metadata

{
  "player": {
    "id": "0167700DA5CC",
    "name": "Igor Thiago Nascimento Rodrigues",
    "position": "F",
    "number": 9,
    "numerical_id": 688348,
    "base_id": 369880
  },
  "team": {
    "id": "B196AD1A3F37",
    "name": "Brentford FC"
  },
  "status": "completed",
  "is_starter": true
}

🌟 Featured Player Example: Igor Thiago

Match Performance: 2 Goals (including winner)

Goal-Scoring Detail

{
  "goals": 2.0,
  "winning_goal": 1.0,
  "first_goal_scorer": 1,
  "goals_openplay": 1.0,
  "att_pen_goal": 1.0,
  "att_ibox_goal": 2.0,
  "big_chance_scored": 2.0,
  "total_scoring_att": 4.0,
  "ontarget_scoring_att": 2.0,
  "shot_off_target": 2.0
}

Shot Placement Breakdown

{
  "att_lf_goal": 1.0,      // Left foot goal
  "att_rf_goal": 1.0,      // Right foot goal
  "att_hd_miss": 1.0,      // Headed shot missed
  "att_goal_low_left": 1.0,   // Goal bottom left
  "att_goal_high_left": 1.0,  // Goal top left
  "att_miss_right": 1.0,      // Shot missed right
  "att_bx_centre": 3.0        // Shots from central box
}

🎯 Player Categories Deep Dive

Passing Statistics

Example: Jordan Henderson (66 passes)

{
  "total_pass": 66.0,
  "successful_pass": 46.0,
  "unsuccesful_pass": 20.0,
  "fwd_pass": 32.0,
  "backward_pass": 5.0,
  "leftside_pass": 16.0,
  "rightside_pass": 13.0,
  "total_long_balls": 16.0,
  "accurate_long_balls": 6.0,
  "total_through_ball": 0.0,
  "put_through": 1.0,
  "successful_put_through": 1.0,
  "total_chipped_pass": 10.0,
  "accurate_chipped_pass": 4.0,
  "total_cross": 4.0,
  "accurate_cross": 1.0,
  "goal_assist": 1.0,
  "goal_assist_openplay": 1.0,
  "big_chance_created": 1.0
}

Defensive Statistics

Example: Kyle Walker (Burnley)

{
  "total_tackle": 4.0,
  "won_tackle": 3.0,
  "interceptions": 1.0,
  "interception_won": 1.0,
  "total_clearance": 7.0,
  "head_clearance": 5.0,
  "effective_clearance": 7.0,
  "effective_head_clearance": 5.0,
  "ball_recovery": 4.0,
  "blocked_pass": 1.0
}

Dribbling & Ball Carrying

Example: Mikkel Damsgaard

{
  "carries": 11.0,
  "progressive_carries": 9.0,
  "touches": 76.0,
  "touches_in_opp_box": 3.0,
  "touches_in_final_third": 35.0,
  "dispossessed": 1.0,
  "times_tackled": 1.0,
  "won_contest": 1.0,
  "total_contest": 1.0
}

Aerial Statistics

Example: Nathan Collins (CB)

{
  "aerial_won": 3.0,
  "aerial_lost": 4.0,
  "head_clearance": 12.0,
  "effective_head_clearance": 12.0,
  "att_hd_total": 2.0,
  "att_hd_miss": 2.0
}

📊 Player Market Stats

Pre-calculated for betting markets:

{
  "player_goals": 2.0,
  "player_assists": 0.0,
  "player_goals_+_assists": 2.0,
  "player_shots": 4.0,
  "player_shots_on_target": 2.0,
  "player_passes": 8.0,
  "player_passes_completed": 7.0,
  "player_passing_attempts": 8.0,
  "player_tackles": 0.0,
  "player_clearances": 4.0,
  "player_interceptions": 0.0,
  "player_fouls": 0.0,
  "player_fouls_drawn": 1.0,
  "player_cards": 0.0,
  "player_crosses": 0.0,
  "player_dribble_attempts": 0.0,
  "player_saves": 0.0,
  "player_goals_against": 1.0,
  "player_shots_assisted": 0.0,
  "1st_half_player_shots_on_target": 0.0
}

⏱️ Period-by-Period Breakdown

Statistics are available for:

all - Full match aggregates
period_1 - First half only
period_2 - Second half only

Example: Dango Ouattara by Period

Metric	1st Half	2nd Half	Full Match
`goals`	0	1	1
`total_pass`	8	16	24
`successful_pass`	5	7	12
`total_cross`	2	3	5
`total_scoring_att`	0	3	3
`ontarget_scoring_att`	0	1	1

🔑 Key Identifiers

Unique ID System

ID Type	Example	Use Case
`id` (string)	`"0167700DA5CC"`	Primary API reference

📋 Complete Statistic Reference

Match-Level Stats (150+)

Expand full list

Possession & Passing

possession_percentage, total_pass, accurate_pass
fwd_pass, backward_pass, leftside_pass, rightside_pass
total_long_balls, accurate_long_balls
total_through_ball, accurate_through_ball
total_cross, accurate_cross, crosses18yard, crosses18yardplus
total_chipped_pass, accurate_chipped_pass
total_fwd_zone_pass, accurate_fwd_zone_pass
total_back_zone_pass, accurate_back_zone_pass
final_third_entries, pen_area_entries
open_play_pass, successful_open_play_pass

Shooting

total_scoring_att, ontarget_scoring_att, shot_off_target
blocked_scoring_att, attempts_ibox, attempts_obox
att_miss_high, att_miss_left, att_miss_right
att_goal_low_left, att_goal_low_centre, att_goal_high_left
big_chance_created, big_chance_scored, big_chance_missed

Defending

total_tackle, won_tackle
interceptions, interception_won
total_clearance, head_clearance, effective_clearance
ball_recovery, blocked_pass, blocked_cross
ppda, defensive_actions

Duels & Aerials

duel_won, duel_lost
aerial_won, aerial_lost
won_contest, total_contest

Set Pieces

att_corner, corner_taken
total_corners_intobox, accurate_corners_intobox
freekick_cross

Goalkeeping

saves, diving_save, punches
good_high_claim, total_high_claim
keeper_throws, accurate_keeper_throws
goal_kicks, accurate_goal_kicks
total_keeper_sweeper, accurate_keeper_sweeper

Discipline

fouls, fk_foul_won
total_yellow_card
penalty_won, penalty_conceded, penalty_faced

🚀 Use Cases

Use Case	Relevant Stats
xG Models	Shot location, body part, assist type, big chances
Player Ratings	All categories weighted by position
Betting Analytics	Market stats, period breakdowns
Fantasy Sports	Goals, assists, clean sheets, bonus triggers
Scouting	Progressive carries, final third entries, defensive actions
Broadcasting	Real-time stat overlays, comparison widgets

📞 Questions?

For API access, custom integrations, or additional statistics requirements, contact your account manager or technical support team.