📊 Overview

Our API provides enterprise-grade NFL statistics covering:

Category	Stat Count	Coverage
Match Stats	50+ metrics	Team-level performance
Player Stats	80+ metrics	Individual performance
Market Stats	15+ metrics	Betting-relevant data
Temporal Data	By quarter	Full game + quarter-by-quarter

🏟️ Sample Match Reference

All examples in this guide are from:

Chicago Bears 24-15 Philadelphia Eagles
NFL | Week 13
November 28, 2025 | Lincoln Financial Field
Philadelphia, PA, USA

📁 Match Statistics Endpoint

Fixture Metadata

Every match includes rich contextual data:

{
  "fixture": {
    "id": "202511284C63B62B",
    "game_id": "24276-17233-25-47",
    "start_date": "2025-11-28T20:00:00Z",
    "home_team_display": "Philadelphia Eagles",
    "away_team_display": "Chicago Bears",
    "status": "completed",
    "venue_name": "Lincoln Financial Field",
    "venue_location": "Philadelphia, PA, USA",
    "venue_neutral": false
  }
}

Score Data

Granular scoring breakdown by quarter:

{
  "scores": {
    "home": {
      "total": 15,
      "periods": {
        "period_1": 0,
        "period_2": 3,
        "period_3": 6,
        "period_4": 6
      }
    },
    "away": {
      "total": 24,
      "periods": {
        "period_1": 7,
        "period_2": 3,
        "period_3": 0,
        "period_4": 14
      }
    }
  }
}

📈 Team Statistics Categories

1. Offensive Statistics

Statistic	Eagles	Bears	Description
`offensive_yards`	317	385	Total offensive yards
`passing_yards`	230	275	Total passing yards
`rushing_yards`	87	110	Total rushing yards
`offensive_first_downs`	14	19	First downs earned
`offensive_turnovers`	2	1	Turnovers committed

Efficiency Metrics:

{
  "passing_yards_per_pass_attempt": 6.8,
  "rushing_yards_per_rush_attempt": 5.1,
  "offensive_first_downs": 14,
  "offensive_turnovers": 2
}

2. Defensive Statistics

Statistic	Eagles	Bears	Description
`sacks`	2	3	Quarterback sacks
`interceptions`	1	2	Interceptions made
`defensive_qb_hits`	6	8	QB hits
`defensive_passes_defended`	7	5	Passes broken up
`defensive_tackles_for_loss`	2	4	TFLs
`fumbles_recovered`	1	0	Fumble recoveries

Real Example - Eagles Defense:

{
  "sacks": 2,
  "interceptions": 1,
  "defensive_qb_hits": 6,
  "defensive_passes_defended": 7,
  "defensive_tackles_for_loss": 2,
  "fumbles_recovered": 1
}

3. Penalties & Discipline

Statistic	Eagles	Bears	Description
`penalties`	7	5	Total penalties
`penalty_yards`	65	40	Penalty yardage

💰 Market Statistics (Betting Data)

Pre-calculated metrics for betting markets:

{
  "market_stats": {
    "home": {
      "team_total": 15,
      "1st_half_team_total": 3,
      "2nd_half_team_total": 12
    },
    "away": {
      "team_total": 24,
      "1st_half_team_total": 10,
      "2nd_half_team_total": 14
    }
  }
}

👤 Player Statistics Endpoint

Player Metadata

{
  "player": {
    "id": "A1B2C3D4E5F6",
    "name": "A.J. Brown",
    "position": "WR",
    "number": 11,
    "numerical_id": 123456,
    "base_id": 78901
  },
  "team": {
    "id": "PHI123",
    "name": "Philadelphia Eagles"
  },
  "status": "completed",
  "is_starter": true
}

🌟 Featured Player Example: A.J. Brown (WR)

Match Performance: 10 receptions, 132 yards, 2 TDs

Receiving Detail

{
  "receptions": 10,
  "receiving_yards": 132,
  "receiving_targets": 12,
  "receiving_touchdowns": 2,
  "longest_reception": 33,
  "yards_after_catch": 23
}

Market Stats

{
  "player_receptions": 10,
  "player_receiving_yards": 132,
  "player_receiving_targets": 12,
  "player_touchdowns": 2
}

🎯 Player Categories Deep Dive

Passing Statistics (Quarterback)

Example: Jalen Hurts

{
  "passing_attempts": 34,
  "passing_completions": 22,
  "passing_yards": 230,
  "passing_touchdowns": 1,
  "passing_interceptions": 1,
  "passing_yards_per_pass_attempt": 6.8,
  "longest_pass": 42,
  "times_sacked": 3,
  "sack_yards_lost": 24
}

Rushing Statistics

Example: Running Back

{
  "rushing_attempts": 17,
  "rushing_yards": 87,
  "rushing_touchdowns": 1,
  "rushing_yards_per_rush_attempt": 5.1,
  "longest_rush": 22,
  "rushing_first_downs": 4
}

Receiving Statistics

Example: A.J. Brown

{
  "receptions": 10,
  "receiving_yards": 132,
  "receiving_targets": 12,
  "receiving_touchdowns": 2,
  "longest_reception": 33,
  "yards_after_catch": 23,
  "receiving_first_downs": 7
}

Defensive Statistics

Example: Adoree' Jackson (CB)

{
  "tackles": 4,
  "assists": 1,
  "interceptions": 0,
  "defensive_passes_defended": 1,
  "defensive_tackles_for_loss": 0,
  "forced_fumbles": 0,
  "fumbles_recovered": 0
}

Special Teams Statistics

Example: Braden Mann (P)

{
  "punts": 5,
  "punt_yards": 245,
  "longest_punt": 63,
  "punts_inside_20": 1,
  "gross_avg_punt_yards": 49.0,
  "touchbacks": 1
}

📊 Player Market Stats

Pre-calculated for betting markets:

{
  "player_receptions": 10,
  "player_receiving_yards": 132,
  "player_receiving_targets": 12,
  "player_rushing_yards": 0,
  "player_rushing_attempts": 0,
  "player_passing_yards": 0,
  "player_passing_attempts": 0,
  "player_passing_completions": 0,
  "player_touchdowns": 2,
  "player_interceptions": 0,
  "player_tackles": 0,
  "player_sacks": 0
}

⏱️ Period-by-Period Breakdown

Statistics are available for:

all - Full game aggregates
period_1 - 1st Quarter
period_2 - 2nd Quarter
period_3 - 3rd Quarter
period_4 - 4th Quarter

Example: Receiving Stats by Quarter

Metric	Q1	Q2	Q3	Q4	Full Game
`receptions`	2	3	2	3	10
`receiving_yards`	28	45	22	37	132
`receiving_touchdowns`	0	1	0	1	2

🔑 Key Identifiers

Unique ID System

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

📋 Complete Statistic Reference

Match-Level Stats (50+)

Offensive

offensive_yards, passing_yards, rushing_yards
offensive_first_downs, offensive_turnovers
passing_yards_per_pass_attempt, rushing_yards_per_rush_attempt
time_of_possession

Defensive

sacks, interceptions, fumbles_recovered
defensive_qb_hits, defensive_passes_defended
defensive_tackles_for_loss

Special Teams

punts, punt_yards, punt_return_yards
kick_return_yards, field_goals_made, field_goals_attempted

Discipline

penalties, penalty_yards

Player-Level Stats (80+)

Passing

passing_attempts, passing_completions, passing_yards
passing_touchdowns, passing_interceptions
times_sacked, sack_yards_lost, longest_pass

Rushing

rushing_attempts, rushing_yards, rushing_touchdowns
longest_rush, rushing_first_downs

Receiving

receptions, receiving_yards, receiving_targets
receiving_touchdowns, longest_reception, yards_after_catch

Defensive

tackles, assists, sacks, interceptions
defensive_passes_defended, defensive_tackles_for_loss
forced_fumbles, fumbles_recovered, qb_hits

Special Teams

punts, punt_yards, punts_inside_20
kick_returns, kick_return_yards, punt_returns

🚀 Use Cases

Use Case	Relevant Stats
Fantasy Sports	Yards, TDs, receptions, targets
Betting Analytics	Market stats, quarter breakdowns
Player Grading	Efficiency metrics, defensive stats
Scouting	Per-attempt metrics, advanced defensive stats
Broadcasting	Real-time stat overlays, comparison widgets
DFS Projections	Targets, snap counts, opportunity share