statshawk, sports stats MCP for builders

NFL

3 visualizations: drive chart, yardage log, team stats

Visualize a game's drives

Seahawks at Patriots, Super Bowl LX

Every drive of the 2025 season game, plotted by field position and colored by how it ended: 28 drives, reproducible from the endpoint below.

Seattle Seahawks

Final

New England Patriots

Drive-by-drive field position for Seattle Seahawks at New England Patriots, 28 drives, final score Seattle Seahawks 29 - New England Patriots 13
Drive	Field position	Result
	Goal205020Goal
#1	SEA 35 to NE 14	Field Goal 8 plays, 51 yds
#2	NE 28 to SEA 44	Punt 8 plays, 28 yds
#3	SEA 10 to SEA 14	Punt

Data

{
  "away": {
    "name": "Seattle Seahawks",
    "teamId": "team_06fj9hhggsv037pde7qf0fgt1m",
    "score": 29
  },
  "home": {
    "name": "New England Patriots",
    "teamId": "team_06fj9hhfyhz975rwpx6rarpbgr",
    "score": 13
  },
  "date": "2026-02-08T23:30:00Z",
  "drives": [
    {
      "driveNumber": 1,
      "teamName": "Seattle Seahawks",
      "teamId": "team_06fj9hhggsv037pde7qf0fgt1m",
      "result": "Field Goal",
      "isScore": true,
      "yards": 51,
      "plays": 8,
      "start": {
        "period": 1,
        "yardsToEndzone": 65,
        "text": "SEA 35"
      },
      "end": {
        "period": 1,
        "yardsToEndzone": 14,
        "text": "NE 14"
      }
    },
    {
      "driveNumber": 2,
      "teamName": "New England Patriots",
      "teamId": "team_06fj9hhfyhz975rwpx6rarpbgr",
      "result": "Punt",
      "isScore": false,
      "yards": 28,
      "plays": 8,
      "start": {
        "period": 1,
        "yardsToEndzone": 72,
        "text": "NE 28"
      },
      "end": {
        "period": 1,
        "yardsToEndzone": 44,
        "text": "SEA 44"
      }
    },
    {
      "driveNumber": 3,
      "teamName": "Seattle Seahawks",
      "teamId": "team_06fj9hhggsv037pde7qf0fgt1m",
      "result": "Punt",
      "isScore": false,
      "yards": 4,
      "plays": 3,
      "start": {
        "period": 1,
        "yardsToEndzone": 90,
        "text": "SEA 10"
      },
      "end": {
        "period": 1,
        "yardsToEndzone": 86,
        "text": "SEA 14"
      }
    },
    {
      "driveNumber": 4,
      "teamName": "New England Patriots",
      "teamId": "team_06fj9hhfyhz975rwpx6rarpbgr",
      "result": "Punt",
      "isScore": false,
      "yards": 6,
      "plays": 4,
      "start": {
        "period": 1,
        "yardsToEndzone": 64,
        "text": "NE 36"
      },
      "end": {
        "period": 1,
        "yardsToEndzone": 58,
        "text": "NE 42"
      }
    },
    {
      "driveNumber": 5,
      "teamName": "Seattle Seahawks",
      "teamId": "team_06fj9hhggsv037pde7qf0fgt1m",
      "result": "Punt",
      "isScore": false,
      "yards": 10,
      "plays": 6,
      "start": {
        "period": 1,
        "yardsToEndzone": 87,
        "text": "SEA 13"
      },
      "end": {
        "period": 1,
        "yardsToEndzone": 77,
        "text": "SEA 23"
      }
    },
    {
      "driveNumber": 6,
      "teamName": "New England Patriots",
      "teamId": "team_06fj9hhfyhz975rwpx6rarpbgr",
      "result": "Punt",
      "isScore": false,
      "yards": 5,
      "plays": 3,
      "start": {
        "period": 1,
        "yardsToEndzone": 68,
        "text": "NE 32"
      },
      "end": {
        "period": 2,
        "yardsToEndzone": 63,
        "text": "NE 37"
      }
    },
    {
      "driveNumber": 7,
      "teamName": "Seattle Seahawks",
      "teamId": "team_06fj9hhggsv037pde7qf0fgt1m",
      "result": "Field Goal",
      "isScore": true,
      "yards": 55,
      "plays": 8,
      "start": {
        "period": 2,
        "yardsToEndzone": 76,
        "text": "SEA 24"
      },
      "end": {
        "period": 2,
        "yardsToEndzone": 21,
        "text": "NE 21"
      }
    },
    {
      "driveNumber": 8,
      "teamName": "New England Patriots",
      "teamId": "team_06fj9hhfyhz975rwpx6rarpbgr",
      "result": "Punt",
      "isScore": false,
      "yards": -2,
      "plays": 3,
      "start": {
        "period": 2,
        "yardsToEndzone": 65,
        "text": "NE 35"
      },
      "end": {
        "period": 2,
        "yardsToEndzone": 67,
        "text": "NE 33"
      }
    },
    {
      "_truncated": 20
    }
  ]
}

Inspect rush and pass-play yardage

49ers at Eagles, yardage log

San Francisco 49ers at Philadelphia Eagles: 128 yardage-qualified plays with a recorded offensive yardage outcome (61 rushes, 67 pass plays), 6 gains of 20+, longest a 61 yard play. Turnover returns, special teams, penalties and administrative events are excluded: their yardage does not represent an offensive gain, so this is not a snap or pass-attempt total.

San Francisco 49ers

Final

Philadelphia Eagles

128yardage-qualified plays · 61 rushes · 67 pass plays · 6 gains of 20+

Longest play: 61 yards.

Rush and pass-play yardage recorded for San Francisco 49ers at Philadelphia Eagles, 128 yardage-qualified plays (61 rushes, 67 pass plays), longest 61 yards
Play	Type	Yards
1	Rush	-1
2	Pass	+61
3	Rush	0
4	Pass	+11
5	Rush	+3

Data

{
  "away": {
    "name": "San Francisco 49ers",
    "teamId": "team_06fj9hhge9x854m1a362j71yy4",
    "score": 23
  },
  "home": {
    "name": "Philadelphia Eagles",
    "teamId": "team_06fj9hhg91tc7cdcaynt95vkq4",
    "score": 19
  },
  "plays": [
    {
      "sequence": 6200,
      "category": "rush",
      "yards": -1,
      "isScoringPlay": false
    },
    {
      "sequence": 8400,
      "category": "pass",
      "yards": 61,
      "isScoringPlay": false
    },
    {
      "sequence": 10900,
      "category": "rush",
      "yards": 0,
      "isScoringPlay": false
    },
    {
      "sequence": 13100,
      "category": "pass",
      "yards": 11,
      "isScoringPlay": false
    },
    {
      "sequence": 15600,
      "category": "rush",
      "yards": 3,
      "isScoringPlay": false
    },
    {
      "sequence": 17800,
      "category": "pass",
      "yards": 2,
      "isScoringPlay": true
    },
    {
      "sequence": 25000,
      "category": "rush",
      "yards": 2,
      "isScoringPlay": false
    },
    {
      "sequence": 27200,
      "category": "rush",
      "yards": 29,
      "isScoringPlay": false
    },
    {
      "_truncated": 120
    }
  ]
}

Reproduce this

getContestPlays -> keep only rush and pass plays with a recorded offensive yardage outcome, by play_type allowlist (rush, pass, sack) -> per-play yardage. Excluded: kickoffs, punts and field goals (kick distance), interception returns (defensive yardage), fumble recoveries (ambiguous, may double count a snap), penalties and administrative events. Not a snap or pass-attempt total.
Free tier, 1 full-detail play-by-play call, cache: hub (1h)
Curated config (curated marquee 2025 game, 2026-09-03): 128 yardage-qualified plays (61 rushes, 67 pass plays); yardage -18 to 61, 6 gains of 20+, longest a 61 yard Purdy to Robinson pass

Build a team stat card

Kansas City Chiefs, 2025 season

Kansas City Chiefs's 2025 regular season across 4 tracked phases: passing, rushing, kicking, punting.

Kansas City Chiefs

2025 season

Passing

Yards: 3,947
TD: 23
Yds/att: 6.8

Rushing

Yards: 1,812
TD: 15
Yds/carry: 4.2

Kicking

FGM-FGA: 33-38
FG%: 86.8%

Punting

Punts: 56
Avg: 47.6

Kicking and punting are tracked as their own phases here, a level of special-teams depth NFL box scores carry that college football's box scores don't.

Data

{
  "teamName": "Kansas City Chiefs",
  "teamId": "team_06fj9hhfg5xp3d2njpwgpakw2r",
  "season": 2025,
  "groups": [
    {
      "key": "passing",
      "label": "Passing",
      "stats": [
        {
          "label": "Yards",
          "value": "3,947"
        },
        {
          "label": "TD",
          "value": "23"
        },
        {
          "label": "Yds/att",
          "value": "6.8"
        }
      ]
    },
    {
      "key": "rushing",
      "label": "Rushing",
      "stats": [
        {
          "label": "Yards",
          "value": "1,812"
        },
        {
          "label": "TD",
          "value": "15"
        },
        {
          "label": "Yds/carry",
          "value": "4.2"
        }
      ]
    },
    {
      "key": "kicking",
      "label": "Kicking",
      "stats": [
        {
          "label": "FGM-FGA",
          "value": "33-38"
        },
        {
          "label": "FG%",
          "value": "86.8%"
        }
      ]
    },
    {
      "key": "punting",
      "label": "Punting",
      "stats": [
        {
          "label": "Punts",
          "value": "56"
        },
        {
          "label": "Avg",
          "value": "47.6"
        }
      ]
    }
  ]
}

Reproduce this

getTeamStats -> passing/rushing/kicking/punting stat lines
Free tier, 1 team stats call, cache: team/player (6h)
Curated config (curated marquee 2025 team, 2026-09-01): Passing 3,947 yds / 23 TD, rushing 1,812 yds / 15 TD, kicking 33/38 FG (86.8%)

Authenticated request · GET /v1/teams/team_06fj9hhfg5xp3d2njpwgpakw2r/stats?competition=nfl&season=2025

MLB

5 visualizations: Statcast matchup, threshold card, injury report, today's slate, roster snippet

Visualize a batter-pitcher matchup

Fernando Tatís Jr. vs Shohei Ohtani

Fernando Tatis Jr. vs Shohei Ohtani, season-to-date pitch locations in the strike zone.

2026 season

Shohei Ohtani23 pitches · RHP · LAD

Fernando Tatis Jr.574 at bats · RHB · SD

the read · AVG

Jr. hits .421 up and in and just .219 down and in.

the numbers

Hottest: up and in; .421
Coldest: down and in; .219
Top whiff: down and away, chasing; 62%
Go-to: Sweeper; 12 of 23

Batting average by zone

cold

hot

Shohei Ohtani · 23 pitches

Sweeper12

Four-Seam Fastball6

Sinker4

Curveball1

Fernando Tatis Jr.'s 2026 zone profile across 144 games vs. the pitches Shohei Ohtani threw him this season. Built on get_play_by_play(detail='full').

Data

{
  "season": 2026,
  "games_scanned": 144,
  "batter": {
    "name": "Fernando Tatis Jr."
  },
  "pitcher": {
    "name": "Shohei Ohtani"
  },
  "zones": {
    "1": {
      "avg": 0.421,
      "slg": 0.737,
      "whiff": 0.125,
      "ab": 19,
      "swings": 40,
      "pitches": 71
    },
    "2": {
      "avg": 0.333,
      "slg": 0.564,
      "whiff": 0.14,
      "ab": 39,
      "swings": 93,
      "pitches": 122
    },
    "3": {
      "avg": 0.268,
      "slg": 0.415,
      "whiff": 0.212,
      "ab": 41,
      "swings": 66,
      "pitches": 95
    },
    "4": {
      "avg": 0.333,
      "slg": 0.583,
      "whiff": 0.04,
      "ab": 48,
      "swings": 75,
      "pitches": 115
    },
    "5": {
      "avg": 0.333,
      "slg": 0.56,
      "whiff": 0.077,
      "ab": 75,
      "swings": 130,
      "pitches": 169
    },
    "6": {
      "avg": 0.407,
      "slg": 0.61,
      "whiff": 0.078,
      "ab": 59,
      "swings": 103,
      "pitches": 146
    },
    "7": {
      "avg": 0.219,
      "slg": 0.406,
      "whiff": 0.175,
      "ab": 32,
      "swings": 57,
      "pitches": 105
    },
    "8": {
      "avg": 0.347,
      "slg": 0.612,
      "whiff": 0.111,
      "ab": 49,
      "swings": 81,
      "pitches": 121
    },
    "9": {
      "avg": 0.266,
      "slg": 0.313,
      "whiff": 0.147,
      "ab": 64,
      "swings": 95,
      "pitches": 148
    },
    "11": {
      "avg": 0.118,
      "slg": 0.118,
      "whiff": 0.415,
      "ab": 17,
      "swings": 41,
      "pitches": 239
    },
    "12": {
      "avg": 0.227,
      "slg": 0.273,
      "whiff": 0.442,
      "ab": 22,
      "swings": 43,
      "pitches": 174
    },
    "13": {
      "avg": 0.132,
      "slg": 0.263,
      "whiff": 0.426,
      "ab": 38,
      "swings": 68,
      "pitches": 249
    },
    "14": {
      "avg": 0.169,
      "slg": 0.169,
      "whiff": 0.623,
      "ab": 71,
      "swings": 167,
      "pitches": 538
    }
  }
}

Reproduce this

buildZoneMatchupData: listPersonGameLog(batter) -> per-game getContestPlayByPlay(detail=full, batter_id) -> aggregate zones, overlay pitcher (season-to-date)
Free tier, metered: fans out ~1 full-detail play-by-play request (5 units) per game in the batter's season, cache: 6h (buildZoneMatchupData internal)

Authenticated request · GET /v1/persons/per_06fhk442hdvh19ga819641j9p8/game-log?competition=mlb&season=2026

curl "https://api.statshawk.ai/v1/persons/per_06fhk442hdvh19ga819641j9p8/game-log?competition=mlb&season=2026" \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"

Request template · GET /v1/contests/{game}/play-by-play?detail=full&batter_id=per_06fhk442hdvh19ga819641j9p8 (per game in the batter's season log)

Build a threshold-performance card

Freddie Freeman, hits vs. 1.5

Freddie Freeman cleared 1.5 hits in 7 of his last 20 games (35%), averaging 1.00 per game over that stretch.

Freddie Freeman

Hits vs. 1.5

35%

Cleared 1.5 hits in 7 of his last 20 games. Averaging 1.00 hits per game over that stretch.

Freddie Freeman's last 20 games, hits vs. a 1.5 threshold: cleared 7, did not clear 13
Game	Hits	Result
G1	0	Did not clear
G2	3	Cleared
G3	2	Cleared
G4	1	Did not clear
G5	0	Did not clear
G6	1

Data

{
  "personName": "Freddie Freeman",
  "stat": "batting.h",
  "statLabel": "Hits",
  "line": 1.5,
  "overRate": 0.35,
  "games": 20,
  "average": 1,
  "gameLog": [
    0,
    3,
    2,
    1,
    0,
    1,
    2,
    0,
    {
      "_truncated": 12
    }
  ]
}

Reproduce this

getPlayerProp -> last 20 games' values -> cleared-vs-line count and average
Free tier, 1 player-prop call, cache: team/player (6h)
Curated config (curated current MLB hitter, 2026-09-01): Cleared 1.5 hits in 7 of his last 20 games (35%), averaging 1.10 hits/game

Authenticated request · GET /v1/analysis/player-prop?person_id=per_06fhk442p1t410zz3pj9fk96h4&stat=batting.h&line=1.5&competition=mlb&season=2026

curl "https://api.statshawk.ai/v1/analysis/player-prop?person_id=per_06fhk442p1t410zz3pj9fk96h4&stat=batting.h&line=1.5&competition=mlb&season=2026" \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"

Build this view in the API reference

Build an injury report for your app

MLB injury report

5 notable MLB players currently on the injured list, each with a current status and expected return.

Injury report

Current injuries to notable MLB players, with each player's status and expected return.

Injury report for 5 notable MLB players currently on the injured list
Player	Status	Injury	Return
Giancarlo StantonNew York Yankees	60-Day-IL Calf · No timetable	Calf	No timetable
Spencer StriderAtlanta Braves	60-Day-IL Elbow · No timetable	Elbow	No timetable
Justin VerlanderDetroit Tigers	60-Day-IL Hamstring/Hip · No timetable	Hamstring/Hip	No timetable
Byron BuxtonMinnesota Twins	10-Day-IL Hip · No timetable	Hip	No timetable
Carlos CorreaHouston Astros	60-Day-IL Ankle · No timetable	Ankle	No timetable

Data

{
  "rows": [
    {
      "personId": "per_06fhk94nw5vq54nqr0ejvrv3rc",
      "name": "Giancarlo Stanton",
      "teamName": "New York Yankees",
      "teamId": "team_06fhk442w5vw5czxwa06993p4m",
      "status": "60-Day-IL",
      "injury": "Calf"
    },
    {
      "personId": "per_06fhk94jm1z116hr0b9pacsmqc",
      "name": "Spencer Strider",
      "teamName": "Atlanta Braves",
      "teamId": "team_06fhk44171z33c4fnrz72v2458",
      "status": "60-Day-IL",
      "injury": "Elbow"
    },
    {
      "personId": "per_06fhk9676hy974yschh9vxfbqm",
      "name": "Justin Verlander",
      "teamName": "Detroit Tigers",
      "teamId": "team_06fhk43sgdr31ap9jmn8w8z6xr",
      "status": "60-Day-IL",
      "injury": "Hamstring/Hip"
    },
    {
      "personId": "per_06fhk43xs5ws39nc8pdf16qycg",
      "name": "Byron Buxton",
      "teamName": "Minnesota Twins",
      "teamId": "team_06fhk43x6ns73bep11zcyvzshr",
      "status": "10-Day-IL",
      "injury": "Hip"
    },
    {
      "personId": "per_06fhk92881x71309ntvwfb0erw",
      "name": "Carlos Correa",
      "teamName": "Houston Astros",
      "teamId": "team_06fhk43sghtn733je04x8aapgr",
      "status": "60-Day-IL",
      "injury": "Ankle"
    }
  ]
}

Reproduce this

getPerson per curated player -> current injury status + expected return
Free tier, 1 person-detail call per tracked player (7), cache: hub (1h)
Curated config (notable currently-injured players, resolved via person injury slot, 2026-09-01)

Request template · GET /v1/persons/{personId} (per curated player, for the current-injury slot)

Build a scoreboard strip for your app

MLB today's slate

15 MLB games today, showing the first 6.

15 games today

Colorado RockiesatDetroit Tigers1:10 PM
New York MetsatNew York Yankees1:35 PM
Pittsburgh PiratesatChicago Cubs2:20 PM
Baltimore OriolesatToronto Blue Jays3:07 PM
San Diego PadresatSan Francisco Giants4:05 PM
Los Angeles AngelsatWashington Nationals4:05 PM

Showing 6 of 15

Data

{
  "date": "2026-09-12",
  "totalCount": 15,
  "games": [
    {
      "id": "cst_06g6xqqnfnv15bzbtrq67t5wxm",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Comerica Park",
        "city": "Detroit",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk43sgdr31ap9jmn8w8z6xr",
      "home_team_name": "Detroit Tigers",
      "away_team": "team_06fhk43x6sw45cp01j354b4j38",
      "away_team_name": "Colorado Rockies",
      "kickoff": "2026-09-12T17:10:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqqpt5z03ann9tnbht62sc",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Yankee Stadium",
        "city": "Bronx",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk442w5vw5czxwa06993p4m",
      "home_team_name": "New York Yankees",
      "away_team": "team_06fhk43tn5s934vszscsmpsvjw",
      "away_team_name": "New York Mets",
      "kickoff": "2026-09-12T17:35:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqqr45r85c9f6983j0nqz0",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Wrigley Field",
        "city": "Chicago",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk43wedvj5b994ftt6tgarr",
      "home_team_name": "Chicago Cubs",
      "away_team": "team_06fhk43me1wj7bfsz5fpte5v4w",
      "away_team_name": "Pittsburgh Pirates",
      "kickoff": "2026-09-12T18:20:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqqs55s555z2z04mpbd1nr",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Rogers Centre",
        "city": "Toronto",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk43q3szc742x4drqcnaea4",
      "home_team_name": "Toronto Blue Jays",
      "away_team": "team_06fhk43ns5xg56gzacqk77rmcg",
      "away_team_name": "Baltimore Orioles",
      "kickoff": "2026-09-12T19:07:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqqv8szz79pbg9q2x0wkq0",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Oracle Park",
        "city": "San Francisco",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk4416xxa39gmfhwmbf11dg",
      "home_team_name": "San Francisco Giants",
      "away_team": "team_06fhk44209rb318tgjm8ve9504",
      "away_team_name": "San Diego Padres",
      "kickoff": "2026-09-12T20:05:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqqt6sz97d7cmz4ywgman8",
      "edition": "edt_06fhk43hyxxx7ftz0erwbcj64r",
      "competition": "comp_06fhk43hyhx6160fgg0kcjd0ar",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Nationals Park",
        "city": "Washington",
        "country": null,
        "neutral_site": false
      },
      "home_team": "team_06fhk43ns9wv79ekmscyazah00",
      "home_team_name": "Washington Nationals",
      "away_team": "team_06fhk4408sv774zcmrxgs959m0",
      "away_team_name": "Los Angeles Angels",
      "kickoff": "2026-09-12T20:05:00Z",
      "score": null,
      "status": "scheduled"
    }
  ]
}

Build a roster directory for your app

New York Yankees roster

New York Yankees: showing 8 of 115 roster entries (a sample, not the full roster).

New York Yankees

115 on roster

Luis Garcia Jr.1B
Jorbit Vivas3B
Heliot RamosLF
Jazz Chisholm Jr.2B
Anthony VolpeSS
Ben RiceDH
Jasson DominguezRF
David BednarRP

Showing 8 of 115 (a sample, not the full roster)

Data

{
  "teamId": "team_06fhk442w5vw5czxwa06993p4m",
  "teamName": "New York Yankees",
  "totalCount": 115,
  "players": [
    {
      "personId": "per_06fhk43pysv473tfv4xa9n1knr",
      "name": "Luis Garcia Jr.",
      "position": "1B"
    },
    {
      "personId": "per_06fhk43pzxzt3e941tebecpjqg",
      "name": "Jorbit Vivas",
      "position": "3B"
    },
    {
      "personId": "per_06fhk441q9ve34vb38fx0xmz0r",
      "name": "Heliot Ramos",
      "position": "LF"
    },
    {
      "personId": "per_06fhk443nnwj7dfnevnqqc89n8",
      "name": "Jazz Chisholm Jr.",
      "position": "2B"
    },
    {
      "personId": "per_06fhk443nst05ctcja0fgcnd2g",
      "name": "Anthony Volpe",
      "position": "SS"
    },
    {
      "personId": "per_06fhk443p1yr7bzyscsmd2mrfm",
      "name": "Ben Rice",
      "position": "DH"
    },
    {
      "personId": "per_06fhk443p5rf14prc3pdpqm9wc",
      "name": "Jasson Dominguez",
      "position": "RF"
    },
    {
      "personId": "per_06fhk443q1xb3a4ehhjq18qycr",
      "name": "David Bednar",
      "position": "RP"
    }
  ]
}

Reproduce this

listTeamRoster -> total count + the first 8 entries (a sample, not the full roster)
Free tier, 1 roster call, cache: team/player (6h)
Curated config (team_id resolved via team search, 2026-09-02): curated team: New York Yankees

Authenticated request · GET /v1/teams/team_06fhk442w5vw5czxwa06993p4m/roster?season=2026

NCAA

3 visualizations: schedule and results, team stats, next game

Build a schedule page for your team

Notre Dame football schedule

Notre Dame's full 2026 football schedule -- results and upcoming games -- reproducible from the endpoints below, currently 1-0.

Notre Dame

Fighting Irish · 2026 season

Record1-0

Results

Notre Dame's completed 2026 football results
Date	Opponent	Result
Sep 6, 7:30 PM EDT	vsWisconsin Badgers	W 41-13

Upcoming

Notre Dame's upcoming 2026 football schedule
Date	Opponent
Sep 12, 3:30 PM EDT	vsRice Owls
Sep 19, 7:30 PM EDT	vsMichigan State Spartans

Data

{
  "school": "Notre Dame",
  "mascot": "Fighting Irish",
  "crestTeamId": "team_06fj8v23jhvv5e2rfsxcgtcp3r",
  "colors": {
    "primary": "#0C2340",
    "secondary": "#C99700"
  },
  "season": 2026,
  "record": {
    "wins": 1,
    "losses": 0,
    "ties": 0
  },
  "results": [
    {
      "opponentId": "team_06fj8v2qvxrt78298knhbktzt4",
      "opponentName": "Wisconsin Badgers",
      "home": true,
      "teamScore": 41,
      "opponentScore": 13,
      "outcome": "win",
      "kickoff": "2026-09-06T23:30:00Z",
      "status": "final"
    }
  ],
  "upcoming": [
    {
      "opponentId": "team_06fj8v28zhrf586fa8qc0fyav8",
      "opponentName": "Rice Owls",
      "home": true,
      "teamScore": null,
      "opponentScore": null,
      "outcome": null,
      "kickoff": "2026-09-12T19:30:00Z",
      "status": "scheduled"
    },
    {
      "opponentId": "team_06fj8v1n5hse3a2fwdwqxsvhf8",
      "opponentName": "Michigan State Spartans",
      "home": true,
      "teamScore": null,
      "opponentScore": null,
      "outcome": null,
      "kickoff": "2026-09-19T23:30:00Z",
      "status": "scheduled"
    }
  ]
}

Reproduce this

listEditions -> current season, or the most recent with Final games -> listTeamGameLog -> Final rows chronological (results) + Scheduled rows soonest-first (upcoming); getTeam for the shown opponents' names
Free tier, 1 editions lookup + 1-2 team game-log calls (season fallback) + opponent-name lookups, cache: hub (1h)
Curated config (canonical football team_id resolved via games search, 2026-08-31)

Build a team stat card

Notre Dame, 2025 season

Notre Dame's 2025 regular season across 3 tracked phases: passing, rushing, receiving.

Notre Dame

Fighting Irish · 2025 season

Passing

Yards: 3,061
TD: 25
Yds/att: 9.5

Rushing

Yards: 2,472
TD: 38
Yds/carry: 6.0

Receiving

Rec: 217
Yards: 3,061
Yds/rec: 14.1

College box scores track passing, rushing, and receiving here. Special teams (kicking, punting) aren't broken out the way NFL box scores are, so this card doesn't show a kicking or punting group.

Data

{
  "school": "Notre Dame",
  "mascot": "Fighting Irish",
  "crestTeamId": "team_06fj8v23jhvv5e2rfsxcgtcp3r",
  "colors": {
    "primary": "#0C2340",
    "secondary": "#C99700"
  },
  "season": 2025,
  "groups": [
    {
      "key": "passing",
      "label": "Passing",
      "stats": [
        {
          "label": "Yards",
          "value": "3,061"
        },
        {
          "label": "TD",
          "value": "25"
        },
        {
          "label": "Yds/att",
          "value": "9.5"
        }
      ]
    },
    {
      "key": "rushing",
      "label": "Rushing",
      "stats": [
        {
          "label": "Yards",
          "value": "2,472"
        },
        {
          "label": "TD",
          "value": "38"
        },
        {
          "label": "Yds/carry",
          "value": "6.0"
        }
      ]
    },
    {
      "key": "receiving",
      "label": "Receiving",
      "stats": [
        {
          "label": "Rec",
          "value": "217"
        },
        {
          "label": "Yards",
          "value": "3,061"
        },
        {
          "label": "Yds/rec",
          "value": "14.1"
        }
      ]
    }
  ]
}

Reproduce this

getTeamStats -> passing/rushing/receiving stat lines (college has no kicking/punting phase)
Free tier, 1 team stats call, cache: team/player (6h)
Curated config (curated marquee 2025 team (team id shared with the schedule widget), 2026-09-01): Passing 3,061 yds / 25 TD, rushing 2,472 yds / 38 TD

Authenticated request · GET /v1/teams/team_06fj8v23jhvv5e2rfsxcgtcp3r/stats?competition=ncaaf&season=2025

Build a next-game card for your app

Notre Dame next game

Notre Dame's next scheduled game: vs Rice Owls.

Notre Dame

Rice Owls

Sat, 3:30 PM EDT

Data

{
  "school": "Notre Dame",
  "mascot": "Fighting Irish",
  "crestTeamId": "team_06fj8v23jhvv5e2rfsxcgtcp3r",
  "opponentId": "team_06fj8v28zhrf586fa8qc0fyav8",
  "opponentName": "Rice Owls",
  "home": true,
  "kickoff": "2026-09-12T19:30:00Z"
}

Reproduce this

resolveNcaaSchedule(Notre Dame) -> upcoming[0] (soonest scheduled game)
Free tier, 0 extra calls (reuses the schedule widget's cached fetch), cache: hub (1h)
Curated config (canonical football team_id resolved via games search, 2026-08-31)

Authenticated request · GET /v1/teams/team_06fj8v23jhvv5e2rfsxcgtcp3r/game-log?competition=ncaaf&season=2026&from=2026-08-29T16:00:00Z&to=2026-09-20T03:00:00Z

curl "https://api.statshawk.ai/v1/teams/team_06fj8v23jhvv5e2rfsxcgtcp3r/game-log?competition=ncaaf&season=2026&from=2026-08-29T16:00:00Z&to=2026-09-20T03:00:00Z" \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"

Request template · GET /v1/teams/{opponentId} (per distinct shown opponent, for names)

GET https://api.statshawk.ai/v1/teams/{opponentId}  (per distinct shown opponent, for names)

Authenticated request · GET /v1/assets/team-logo/team_06fj8v23jhvv5e2rfsxcgtcp3r (crest)

curl "https://api.statshawk.ai/v1/assets/team-logo/team_06fj8v23jhvv5e2rfsxcgtcp3r  (crest)" \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"

Build this view in the API reference

EPL

2 visualizations: matchday, league table

Build a matchday tracker for your app

Premier League matchday

The current Premier League matchday: recent results and next fixtures.

Recent results
Match	Score	Venue	Kickoff	Status
ChelseaatArsenal	1-2	Emirates Stadium	Sep 6, 11:30 AM EDT	Final
Manchester UnitedatEverton	2-2	Hill Dickinson Stadium	Sep 6, 9:00 AM EDT	Final
Aston VillaatHull City	0-0	The MKM Stadium	Sep 5, 12:30 PM EDT	Final
Crystal PalaceatFulham	3-2	Craven Cottage	Sep 5, 10:00 AM EDT	Final
Leeds UnitedatBrighton & Hove Albion	1-1	American Express Stadium	Sep 5, 10:00 AM EDT	Final
Tottenham HotspuratNottingham Forest	0-0	The City Ground	Sep 5, 10:00 AM EDT	Final
SunderlandatBrentford	1-1	Gtech Community Stadium	Sep 5, 10:00 AM EDT	Final
Coventry CityatManchester City	0-1	Etihad Stadium	Sep 5, 10:00 AM EDT	Final
AFC BournemouthatNewcastle United	2-2	St. James' Park	Sep 5, 7:30 AM EDT	Final

Upcoming fixtures
Match	Score	Venue	Kickoff	Status
FulhamatLiverpool	Score pending	Anfield	Sep 12, 10:00 AM EDT	Scheduled
Hull CityatChelsea	Score pending	Stamford Bridge	Sep 12, 10:00 AM EDT	Scheduled

Data

{
  "recent": [
    {
      "id": "cst_06g4zz8kn1tf3fqmgk4swyrs0g",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Emirates Stadium",
        "city": "London",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgknw33e233vtd3fer98",
      "home_team_name": "Arsenal",
      "away_team": "team_06fhmsvgndrw10x2ecxkgm62rr",
      "away_team_name": "Chelsea",
      "kickoff": "2026-09-06T15:30:00Z",
      "score": {
        "home": 2,
        "away": 1
      },
      "status": "final"
    },
    {
      "id": "cst_06g4zz8jkxzr79xhw7pn052dy8",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Hill Dickinson Stadium",
        "city": "Liverpool",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgphy071kc7m1674rarw",
      "home_team_name": "Everton",
      "away_team": "team_06fhmsvgs1xt56mzevtzgqc38c",
      "away_team_name": "Manchester United",
      "kickoff": "2026-09-06T13:00:00Z",
      "score": {
        "home": 2,
        "away": 2
      },
      "status": "final"
    },
    {
      "id": "cst_06g4nmb5z1yz11ps2pcx5ehbq8",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "The MKM Stadium",
        "city": "Hull",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgq1x11a92gdgwwr7pnm",
      "home_team_name": "Hull City",
      "away_team": "team_06fhmsvgm5va3crs2s67vsn8gc",
      "away_team_name": "Aston Villa",
      "kickoff": "2026-09-05T16:30:00Z",
      "score": {
        "home": 0,
        "away": 0
      },
      "status": "final"
    },
    {
      "_truncated": 6
    }
  ],
  "upcoming": [
    {
      "id": "cst_06g6xqmgfxvb10x5d0m0svd6n8",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Anfield",
        "city": "Liverpool",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgr5zc79hjgzaptdepgc",
      "home_team_name": "Liverpool",
      "away_team": "team_06fhmsvgpszm392bet6sf16g6m",
      "away_team_name": "Fulham",
      "kickoff": "2026-09-12T14:00:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqme05xb3065s1gkfd2nqg",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Stamford Bridge",
        "city": "London",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgndrw10x2ecxkgm62rr",
      "home_team_name": "Chelsea",
      "away_team": "team_06fhmsvgq1x11a92gdgwwr7pnm",
      "away_team_name": "Hull City",
      "kickoff": "2026-09-12T14:00:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "id": "cst_06g6xqmf5svj7a60zrd38pgjkg",
      "edition": "edt_06fvn8zaw9sy1f4jjqp8dwrhzr",
      "competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
      "event": null,
      "stage": "regular",
      "location": {
        "venue_name": "Selhurst Park",
        "city": "London",
        "country": "England",
        "neutral_site": null
      },
      "home_team": "team_06fhmsvgp9yx14aqwnwb9rvhmw",
      "home_team_name": "Crystal Palace",
      "away_team": "team_06fhmsvgq9yf74yj98c26z0yhr",
      "away_team_name": "Ipswich Town",
      "kickoff": "2026-09-12T14:00:00Z",
      "score": null,
      "status": "scheduled"
    },
    {
      "_truncated": 7
    }
  ]
}

Build a mini league table for your app

Premier League table

All 20 Premier League clubs by points (our own sort of the standings data, not an official league table position).

Premier League clubs for the 2026 season, by our own sort of points
#	Club	W	L	D	PTS
1	Arsenal	3	0	0	9
2	Manchester City	3	0	0	9
3	Hull City	2	0	1	7
4	Chelsea	2	1	0	6
5	Brentford	1	0	2	5
6	Everton	1	0	2	5
7	Leeds United	1	0	2	5
8	Liverpool	1	0	2	5
9	Newcastle United	1	0	2	5
10	Brighton & Hove Albion	1	1	1	4
11	Manchester United	1	1	1	4
12	Sunderland	1	1	1	4
13	Crystal Palace	1	2	0	3
14	Ipswich Town	1	2	0	3
15	AFC Bournemouth	0	1	2	2
16	Nottingham Forest	0	1	2	2
17	Aston Villa	0	2	1	1
18	Tottenham Hotspur	0	2	1	1
19	Coventry City	0	3	0	0
20	Fulham	0	3	0	0

Data

{
  "season": 2026,
  "usesPoints": true,
  "rows": [
    {
      "rank": 1,
      "teamId": "team_06fhmsvgknw33e233vtd3fer98",
      "name": "Arsenal",
      "wins": 3,
      "losses": 0,
      "ties": 0,
      "points": 9,
      "pct": 1
    },
    {
      "rank": 2,
      "teamId": "team_06fhmsvgrhsm723zk1wqq5yrt8",
      "name": "Manchester City",
      "wins": 3,
      "losses": 0,
      "ties": 0,
      "points": 9,
      "pct": 1
    },
    {
      "rank": 3,
      "teamId": "team_06fhmsvgq1x11a92gdgwwr7pnm",
      "name": "Hull City",
      "wins": 2,
      "losses": 0,
      "ties": 1,
      "points": 7,
      "pct": 0.8333333333333334
    },
    {
      "rank": 4,
      "teamId": "team_06fhmsvgndrw10x2ecxkgm62rr",
      "name": "Chelsea",
      "wins": 2,
      "losses": 1,
      "ties": 0,
      "points": 6,
      "pct": 0.6666666666666666
    },
    {
      "rank": 5,
      "teamId": "team_06fhmsvgmhts1ea9p4hggv9500",
      "name": "Brentford",
      "wins": 1,
      "losses": 0,
      "ties": 2,
      "points": 5,
      "pct": 0.6666666666666666
    },
    {
      "rank": 6,
      "teamId": "team_06fhmsvgphy071kc7m1674rarw",
      "name": "Everton",
      "wins": 1,
      "losses": 0,
      "ties": 2,
      "points": 5,
      "pct": 0.6666666666666666
    },
    {
      "rank": 7,
      "teamId": "team_06fhmsvgqnyr147pxf862q7bx4",
      "name": "Leeds United",
      "wins": 1,
      "losses": 0,
      "ties": 2,
      "points": 5,
      "pct": 0.6666666666666666
    },
    {
      "rank": 8,
      "teamId": "team_06fhmsvgr5zc79hjgzaptdepgc",
      "name": "Liverpool",
      "wins": 1,
      "losses": 0,
      "ties": 2,
      "points": 5,
      "pct": 0.6666666666666666
    },
    {
      "_truncated": 12
    }
  ]
}

Reproduce this

listStandings -> sorted by points desc (fallback: win percentage)

WNBA

2 visualizations: playoff picture, record tile

Build a playoff race tracker for your app

WNBA playoff picture

Seeds 1-8 make the playoffs; the widget draws the cut line.

WNBA standings for the 2026 season, with the playoff cut line after the top 8 teams by win percentage
#	Team	W	L	PCT
1	Minnesota Lynx	31	9	0.775
2	Golden State Valkyries	29	11	0.725
3	Las Vegas Aces	27	14	0.659
4	Atlanta Dream	26	14	0.650
5	Indiana Fever	26	14	0.650
6	New York Liberty	25	16	0.610
7	Dallas Wings	24	16	0.600
8	Washington Mystics	24	16	0.600
Playoff cut line: top 8 by win percentage
9	Portland Fire	16	24	0.400
10	Chicago Sky	15	25	0.375
11	Los Angeles Sparks	15	25	0.375
12	Phoenix Mercury	14	26	0.350
13	Toronto Tempo	11	29	0.275
14	Connecticut Sun	10	30	0.250
15	Seattle Storm	8	32	0.200

Data

{
  "season": 2026,
  "rows": [
    {
      "rank": 1,
      "teamId": "team_06fj5q9amxty3epeyaqs4v4jz4",
      "name": "Minnesota Lynx",
      "wins": 31,
      "losses": 9,
      "pct": 0.775
    },
    {
      "rank": 2,
      "teamId": "team_06fj5q99dsrf3betec7ve10ap4",
      "name": "Golden State Valkyries",
      "wins": 29,
      "losses": 11,
      "pct": 0.725
    },
    {
      "rank": 3,
      "teamId": "team_06fj5q984dtn743navhmfmvmpw",
      "name": "Las Vegas Aces",
      "wins": 27,
      "losses": 14,
      "pct": 0.6585365853658537
    },
    {
      "rank": 4,
      "teamId": "team_06fj5q99ghx13fjwzwdrrn7bp4",
      "name": "Atlanta Dream",
      "wins": 26,
      "losses": 14,
      "pct": 0.65
    },
    {
      "rank": 5,
      "teamId": "team_06fj5q9a1ssw386zjfcg6ydvn0",
      "name": "Indiana Fever",
      "wins": 26,
      "losses": 14,
      "pct": 0.65
    },
    {
      "rank": 6,
      "teamId": "team_06fj5q98ghr034f4en1dpaapkc",
      "name": "New York Liberty",
      "wins": 25,
      "losses": 16,
      "pct": 0.6097560975609756
    },
    {
      "rank": 7,
      "teamId": "team_06fj5q9879st3bzsed235vvcm0",
      "name": "Dallas Wings",
      "wins": 24,
      "losses": 16,
      "pct": 0.6
    },
    {
      "rank": 8,
      "teamId": "team_06fj5q98snx5521jenmmrk6r8r",
      "name": "Washington Mystics",
      "wins": 24,
      "losses": 16,
      "pct": 0.6
    },
    {
      "_truncated": 7
    }
  ],
  "cutLine": 8
}

Reproduce this

listStandings -> ranked rows; playoff cut line at seed 8 (curated)
Free tier, 1 editions lookup + 1 standings call, cache: hub (1h)
Curated config (WNBA playoff format (top 8 seeds), 2026-08-31): cut line at seed 8

Build a team record tile for your app

Las Vegas Aces record

Las Vegas Aces is 3rd by win percentage among this season's WNBA teams (our own sort, not an official seed).

Las Vegas Aces

27-14

0.659 win percentage

3rd by win percentage

Data

{
  "teamId": "team_06fj5q984dtn743navhmfmvmpw",
  "name": "Las Vegas Aces",
  "wins": 27,
  "losses": 14,
  "pct": 0.6585365853658537,
  "position": 3
}

Reproduce this

listStandings -> sorted by win percentage (curated team's own computed position)
Free tier, 1 editions lookup + 1 standings call, cache: hub (1h)
Curated config (team_id resolved from live standings, 2026-09-02): curated team: Las Vegas Aces

Authenticated request · GET /v1/competitions/wnba/editions/2026/standings

curl "https://api.statshawk.ai/v1/competitions/wnba/editions/2026/standings" \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"

Build this view in the API reference

StatsHawk sports data API gallery

NFL

Seahawks at Patriots, Super Bowl LX

49ers at Eagles, yardage log

Kansas City Chiefs, 2025 season

Passing

Rushing

Kicking

Punting

MLB

Fernando Tatís Jr. vs Shohei Ohtani

Freddie Freeman, hits vs. 1.5

MLB injury report

Injury report

MLB today's slate

New York Yankees roster

NCAA

Notre Dame football schedule

Results

Upcoming

Notre Dame, 2025 season

Passing

Rushing

Receiving

Notre Dame next game

EPL

Premier League matchday

Premier League table

WNBA

WNBA playoff picture

Las Vegas Aces record

Seahawks at Patriots, Super Bowl LX

49ers at Eagles, yardage log

Kansas City Chiefs, 2025 season

Passing

Rushing

Kicking

Punting

MLB injury report

Injury report

New York Yankees roster

Freddie Freeman, hits vs. 1.5

Notre Dame, 2025 season

Passing

Rushing

Receiving

Las Vegas Aces record

MLB today's slate

WNBA playoff picture

Premier League table

Notre Dame next game

Notre Dame football schedule

Results

Upcoming

Premier League matchday

Fernando Tatís Jr. vs Shohei Ohtani