3 visualizations: drive chart, yardage log, team stats
5 visualizations: Statcast matchup, threshold card, injury report, today's slate, roster snippet
3 visualizations: schedule and results, team stats, next game
2 visualizations: matchday, league table
2 visualizations: playoff picture, record tile
Build a team stat card
Kansas City Chiefs
2025 season
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.
{
"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"
}
]
}
]
}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%)
Build a threshold-performance card
Freddie Freeman
Hits vs. 1.5
Cleared 1.5 hits in 7 of his last 20 games. Averaging 1.00 hits per game over that stretch.
| 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 |
Freddie Freeman cleared 1.5 hits in 7 of his last 20 games (35%), averaging 1.00 hits per game over that stretch.
{
"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
}
]
}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
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 an injury report for your app
Current injuries to notable MLB players, with each player's status and expected return.
| Player | Status | Injury | Return |
|---|---|---|---|
| 60-Day-IL Calf · No timetable | Calf | No timetable | |
| 60-Day-IL Elbow · No timetable | Elbow | No timetable | |
| 60-Day-IL Hamstring/Hip · No timetable | Hamstring/Hip | No timetable | |
| 10-Day-IL Hip · No timetable | Hip | No timetable | |
| 60-Day-IL Ankle · No timetable | Ankle | No timetable |
{
"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"
}
]
}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)
Build a team stat card
Notre Dame
Fighting Irish · 2025 season
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.
{
"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"
}
]
}
]
}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
Build a roster directory for your app
New York Yankees
115 on roster
Showing 8 of 115 (a sample, not the full roster)
{
"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"
}
]
}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
Visualize a game's drives
Seattle Seahawks
29
New England Patriots
13
Inspect rush and pass-play yardage
San Francisco 49ers
23
Philadelphia Eagles
19
128yardage-qualified plays · 61 rushes · 67 pass plays · 6 gains of 20+
Longest play: 61 yards.
curl "https://api.statshawk.ai/v1/teams/team_06fj9hhfg5xp3d2njpwgpakw2r/stats?competition=nfl&season=2025" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"| Did not clear |
| G7 | 2 | Cleared |
| G8 | 0 | Did not clear |
| G9 | 2 | Cleared |
| G10 | 1 | Did not clear |
| G11 | 2 | Cleared |
| G12 | 1 | Did not clear |
| G13 | 2 | Cleared |
| G14 | 0 | Did not clear |
| G15 | 2 | Cleared |
| G16 | 0 | Did not clear |
| G17 | 0 | Did not clear |
| G18 | 1 | Did not clear |
| G19 | 0 | Did not clear |
| G20 | 0 | Did not clear |
GET https://api.statshawk.ai/v1/persons/{personId} (per curated player, for the current-injury slot)curl "https://api.statshawk.ai/v1/teams/team_06fj8v23jhvv5e2rfsxcgtcp3r/stats?competition=ncaaf&season=2025" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"curl "https://api.statshawk.ai/v1/teams/team_06fhk442w5vw5czxwa06993p4m/roster?season=2026" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"| Drive | Field position | Result |
|---|
| SEA 35 to NE 14 | Field Goal 8 plays, 51 yds | |
| NE 28 to SEA 44 | Punt 8 plays, 28 yds | |
| SEA 10 to SEA 14 | Punt 3 plays, 4 yds | |
| NE 36 to NE 42 | Punt 4 plays, 6 yds | |
| SEA 13 to SEA 23 | Punt 6 plays, 10 yds | |
| NE 32 to NE 37 | Punt 3 plays, 5 yds | |
| SEA 24 to NE 21 | Field Goal 8 plays, 55 yds | |
| NE 35 to NE 33 | Punt 3 plays, -2 yds | |
| SEA 29 to NE 42 | Punt 8 plays, 29 yds | |
| NE 2 to NE 12 | Punt 6 plays, 10 yds | |
| SEA 43 to NE 23 | Field Goal 9 plays, 34 yds | |
| NE 29 to NE 29 | End of Half 1 play, -1 yds | |
| NE 32 to NE 39 | Punt 3 plays, 7 yds | |
| SEA 9 to NE 22 | Field Goal 10 plays, 69 yds | |
| NE 32 to NE 41 | Punt 3 plays, 9 yds | |
| SEA 18 to SEA 20 | Punt 3 plays, 2 yds | |
| NE 27 to NE 33 | Punt 3 plays, 6 yds | |
| SEA 21 to SEA 27 | Punt 3 plays, 6 yds | |
| NE 27 to NE 44 | Fumble 5 plays, 10 yds | |
| NE 37 to NE 0 | Touchdown 5 plays, 37 yds | |
| NE 35 to SEA 0 | Touchdown 3 plays, 65 yds | |
| SEA 31 to SEA 41 | Punt 4 plays, 10 yds | |
| NE 4 to NE 44 | Interception 7 plays, 40 yds | |
| NE 38 to NE 8 | Field Goal 6 plays, 30 yds | |
| NE 38 to SEA 44 | Interception Touchdown 4 plays, 18 yds | |
| NE 35 to SEA 0 | Touchdown 8 plays, 65 yds | |
| NE 46 to SEA 42 | Punt 3 plays, -12 yds | |
| NE 6 to NE 47 | End of Game 6 plays, 65 yds |
{
"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
}
]
}getContestDrives -> per-drive field position (start/end yards_to_endzone) + result
Free tier, 1 full-detail play-by-play call, cache: hub (1h)
Curated config (curated marquee 2025 game, 2026-08-31): Super Bowl LX, Seahawks 29, Patriots 13, 28 drives
curl "https://api.statshawk.ai/v1/contests/cst_06fhkfrf6nty130z3eqwf3m4tr/play-by-play?detail=full" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"| Play | Type | Yards | Detail |
|---|
| 1 | Rush | -1 | |
| 2 | Pass | +61 | |
| 3 | Rush | 0 | |
| 4 | Pass | +11 | |
| 5 | Rush | +3 | |
| 6 | Pass | +2 | |
| 7 | Rush | +2 | |
| 8 | Rush | +29 | |
| 9 | Rush | +5 | |
| 10 | Pass | +10 | |
| 11 | Pass | +4 | |
| 12 | Pass | +3 | |
| 13 | Rush | +3 | |
| 14 | Rush | +3 | |
| 15 | Rush | +3 | |
| 16 | Rush | +1 | |
| 17 | Rush | +4 | |
| 18 | Pass | 0 | |
| 19 | Pass | +3 | |
| 20 | Rush | +1 | |
| 21 | Rush | +2 | |
| 22 | Pass | +9 | |
| 23 | Pass | +8 | |
| 24 | Pass | 0 | |
| 25 | Rush | 0 | |
| 26 | Pass | 0 | |
| 27 | Rush | +1 | |
| 28 | Pass | 0 | |
| 29 | Rush | +2 | |
| 30 | Pass | +7 | |
| 31 | Rush | +7 | |
| 32 | Pass | +9 | |
| 33 | Rush | +5 | |
| 34 | Pass | 0 | |
| 35 | Pass | +1 | |
| 36 | Pass | +13 | |
| 37 | Rush | +3 | |
| 38 | Rush | +4 | |
| 39 | Pass | +20 | |
| 40 | Rush | +4 | |
| 41 | Rush | +9 | |
| 42 | Rush | +7 | |
| 43 | Rush | -2 | |
| 44 | Rush | +3 | |
| 45 | Pass | +9 | |
| 46 | Pass | +6 | |
| 47 | Pass | +45 | |
| 48 | Pass | +6 | |
| 49 | Rush | +3 | |
| 50 | Rush | -1 | |
| 51 | Rush | +6 | |
| 52 | Pass | 0 | |
| 53 | Pass | 0 | |
| 54 | Rush | +4 | |
| 55 | Pass | -5 | |
| 56 | Pass | +15 | |
| 57 | Pass | 0 | |
| 58 | Pass | 0 | |
| 59 | Pass | +14 | |
| 60 | Pass | +5 | |
| 61 | Pass | 0 | |
| 62 | Rush | +8 | |
| 63 | Rush | +8 | |
| 64 | Rush | -1 | |
| 65 | Pass | 0 | |
| 66 | Rush | +6 | |
| 67 | Rush | +3 | |
| 68 | Pass | 0 | |
| 69 | Pass | +14 | |
| 70 | Pass | 0 | |
| 71 | Rush | +9 | |
| 72 | Rush | +4 | |
| 73 | Pass | 0 | |
| 74 | Rush | -18 | |
| 75 | Rush | -1 | |
| 76 | Pass | +5 | |
| 77 | Rush | +1 | |
| 78 | Pass | 0 | |
| 79 | Pass | 0 | |
| 80 | Rush | -2 | |
| 81 | Pass | +11 | |
| 82 | Rush | +2 | |
| 83 | Rush | -1 | |
| 84 | Pass | +8 | |
| 85 | Rush | +4 | |
| 86 | Pass | 0 | |
| 87 | Rush | -3 | |
| 88 | Rush | +4 | |
| 89 | Pass | +27 | |
| 90 | Rush | +6 | |
| 91 | Rush | +3 | |
| 92 | Rush | +2 | |
| 93 | Pass | +29 | |
| 94 | Pass | 0 | |
| 95 | Rush | +7 | |
| 96 | Pass | 0 | |
| 97 | Pass | +11 | |
| 98 | Rush | +2 | |
| 99 | Rush | +8 | |
| 100 | Rush | +3 | |
| 101 | Rush | +9 | |
| 102 | Rush | +6 | |
| 103 | Rush | 0 | |
| 104 | Pass | 0 | |
| 105 | Pass | +6 | |
| 106 | Pass | +5 | |
| 107 | Rush | +5 | |
| 108 | Pass | +16 | |
| 109 | Pass | 0 | |
| 110 | Pass | +11 | |
| 111 | Rush | +4 | |
| 112 | Rush | +10 | |
| 113 | Pass | +6 | |
| 114 | Pass | 0 | |
| 115 | Pass | +4 | |
| 116 | Pass | +3 | |
| 117 | Pass | +2 | |
| 118 | Pass | 0 | |
| 119 | Pass | +15 | |
| 120 | Pass | +10 | |
| 121 | Pass | +15 | |
| 122 | Pass | -1 | |
| 123 | Pass | 0 | |
| 124 | Pass | 0 | |
| 125 | Pass | 0 | |
| 126 | Rush | -1 | |
| 127 | Rush | -1 | |
| 128 | Rush | -1 |
{
"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
}
]
}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
curl "https://api.statshawk.ai/v1/contests/cst_06fhkfreydr77293z1z9zxje58/play-by-play?detail=full" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"Build a team record tile for your app
27-14
0.659 win percentage
3rd by win percentage
{
"teamId": "team_06fj5q984dtn743navhmfmvmpw",
"name": "Las Vegas Aces",
"wins": 27,
"losses": 14,
"pct": 0.6585365853658537,
"position": 3
}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
curl "https://api.statshawk.ai/v1/competitions/wnba/editions/2026/standings" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"Build a scoreboard strip for your app
15 games today
Showing 6 of 15
{
"date": "2026-09-12",
"totalCount": 15,
"games": [
{
"id": "cst_06g6xqjykds013j7fqtgjs96b4",
"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": "in_progress"
},
{
"id": "cst_06g6xqjzqsvg155yspf89v5wpc",
"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": "in_progress"
},
{
"id": "cst_06g6xqk0sxrn3d77ryvdrsawgw",
"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": "in_progress"
},
{
"id": "cst_06g6xqk2esyd5dvbg6hbdtf4z8",
"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": "in_progress"
},
{
"id": "cst_06g6xqk3w1xa334ss8pxrk3agc",
"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"
},
{
"id": "cst_06g6xqk50xxy7fk9w3qyvf9vfg",
"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"
}
]
}Build a mini league table for your app
| # | Club | W | L | D | PTS |
|---|---|---|---|---|---|
| 1 | 3 | 0 | 0 | 9 | |
| 2 | 3 | 0 | 0 | 9 | |
| 3 | 2 | 0 | 2 | 8 | |
| 4 | 2 | 1 | 1 | 7 | |
| 5 | 1 | 0 | 3 | 6 | |
| 6 | 1 | 0 | 3 | 6 | |
| 7 | 2 | 2 | 0 | 6 | |
| 8 | 1 | 0 | 2 | 5 | |
| 9 | 1 | 0 | 2 | 5 | |
| 10 | 1 | 0 | 2 | 5 | |
| 11 | 1 | 1 | 2 | 5 | |
| 12 | 1 | 1 | 1 | 4 | |
| 13 | 1 | 1 | 1 | 4 | |
| 14 | 1 | 1 | 1 | 4 | |
| 15 | 0 | 1 | 3 | 3 | |
| 16 | 1 | 3 | 0 | 3 | |
| 17 | 0 | 2 | 1 | 1 | |
| 18 | 0 | 3 | 1 | 1 | |
| 19 | 0 | 3 | 1 | 1 | |
| 20 | 0 | 3 | 0 | 0 |
{
"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": 2,
"points": 8,
"pct": 0.75
},
{
"rank": 4,
"teamId": "team_06fhmsvgndrw10x2ecxkgm62rr",
"name": "Chelsea",
"wins": 2,
"losses": 1,
"ties": 1,
"points": 7,
"pct": 0.625
},
{
"rank": 5,
"teamId": "team_06fhmsvgmhts1ea9p4hggv9500",
"name": "Brentford",
"wins": 1,
"losses": 0,
"ties": 3,
"points": 6,
"pct": 0.625
},
{
"rank": 6,
"teamId": "team_06fhmsvgr5zc79hjgzaptdepgc",
"name": "Liverpool",
"wins": 1,
"losses": 0,
"ties": 3,
"points": 6,
"pct": 0.625
},
{
"rank": 7,
"teamId": "team_06fhmsvgq9yf74yj98c26z0yhr",
"name": "Ipswich Town",
"wins": 2,
"losses": 2,
"ties": 0,
"points": 6,
"pct": 0.5
},
{
"rank": 8,
"teamId": "team_06fhmsvgphy071kc7m1674rarw",
"name": "Everton",
"wins": 1,
"losses": 0,
"ties": 2,
"points": 5,
"pct": 0.6666666666666666
},
{
"_truncated": 12
}
]
}listStandings -> sorted by points desc (fallback: win percentage)
Free tier, 1 editions lookup + 1 standings call, cache: hub (1h)
Build a playoff race tracker for your app
| # | Team | W | L | PCT |
|---|---|---|---|---|
| 1 | 31 | 9 | 0.775 | |
| 2 | 29 | 11 | 0.725 | |
| 3 | 27 | 14 | 0.659 | |
| 4 | 26 | 14 | 0.650 | |
| 5 | 26 | 14 | 0.650 | |
| 6 | 25 | 16 | 0.610 | |
| 7 | 24 | 16 | 0.600 | |
| 8 | 24 | 16 | 0.600 | |
| Playoff cut line: top 8 by win percentage | ||||
| 9 | 16 | 24 | 0.400 | |
| 10 | 15 | 25 | 0.375 | |
| 11 | 15 | 25 | 0.375 | |
| 12 | 14 | 26 | 0.350 | |
| 13 | 11 | 29 | 0.275 | |
| 14 | 10 | 30 | 0.250 | |
| 15 | 8 | 32 | 0.200 | |
{
"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
}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
getLeagueSlateForDate('mlb', date) -> sorted by kickoff, capped to the first 6
Free tier, 1 slate lookup (editions + games), cache: scoreboard (60s)
curl "https://api.statshawk.ai/v1/competitions/mlb/editions/2026/games?date=2026-09-12" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"curl "https://api.statshawk.ai/v1/competitions/epl/editions/2026/standings" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"curl "https://api.statshawk.ai/v1/competitions/wnba/editions/2026/standings" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"Build a next-game card for your app
Next
{
"school": "Notre Dame",
"mascot": "Fighting Irish",
"crestTeamId": "team_06fj8v23jhvv5e2rfsxcgtcp3r",
"opponentId": "team_06fj8v28zhrf586fa8qc0fyav8",
"opponentName": "Rice Owls",
"home": true,
"kickoff": "2026-09-12T19:30:00Z"
}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)
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"GET https://api.statshawk.ai/v1/teams/{opponentId} (per distinct shown opponent, for names)curl "https://api.statshawk.ai/v1/assets/team-logo/team_06fj8v23jhvv5e2rfsxcgtcp3r (crest)" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"Build a schedule page for your team
Notre Dame
Fighting Irish · 2026 season
| Date | Opponent | Result |
|---|---|---|
| vs | W 41-13 |
| Date | Opponent | |
|---|---|---|
| vs | ||
| vs |
{
"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"
}
]
}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)
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"GET https://api.statshawk.ai/v1/teams/{opponentId} (per distinct shown opponent, for names)curl "https://api.statshawk.ai/v1/assets/team-logo/team_06fj8v23jhvv5e2rfsxcgtcp3r (crest)" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"Build a matchday tracker for your app
| Match | Score | Venue | Kickoff | Status |
|---|---|---|---|---|
| 3-2 | Selhurst Park | Final | ||
| 2-2 | Vitality Stadium | Final | ||
| 2-2 | Stamford Bridge | Final | ||
| 0-0 | Anfield | Final | ||
| 2-1 | Villa Park | Final | ||
| 1-2 | Emirates Stadium | Final | ||
| 2-2 | Hill Dickinson Stadium | Final | ||
| 0-0 | The MKM Stadium | Final | ||
| 3-2 | Craven Cottage | Final | ||
| 1-1 | American Express Stadium | Final |
| Match | Score | Venue | Kickoff | Status |
|---|---|---|---|---|
| Score pending | Tottenham Hotspur Stadium | Scheduled | ||
| Score pending | Stadium of Light | Scheduled | ||
{
"recent": [
{
"id": "cst_06g6xqzhrxtk3f38mssn6xq638",
"edition": "edt_06fvn882fnts705e352sckn954",
"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": {
"home": 2,
"away": 3
},
"status": "final"
},
{
"id": "cst_06g6xqzf79sn5f6s0c81phb544",
"edition": "edt_06fvn882fnts705e352sckn954",
"competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
"event": null,
"stage": "regular",
"location": {
"venue_name": "Vitality Stadium",
"city": "Bournemouth",
"country": "England",
"neutral_site": null
},
"home_team": "team_06fhmsvgjxw8752v2j1bkw4vgr",
"home_team_name": "AFC Bournemouth",
"away_team": "team_06fhmsvgmhts1ea9p4hggv9500",
"away_team_name": "Brentford",
"kickoff": "2026-09-12T14:00:00Z",
"score": {
"home": 2,
"away": 2
},
"status": "final"
},
{
"_truncated": 8
}
],
"upcoming": [
{
"id": "cst_06g6xqzk99y43awdk461e7c9v8",
"edition": "edt_06fvn882fnts705e352sckn954",
"competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
"event": null,
"stage": "regular",
"location": {
"venue_name": "Tottenham Hotspur Stadium",
"city": "London",
"country": "England",
"neutral_site": null
},
"home_team": "team_06fhmsvgssvv3bhp5fvw3bkarc",
"home_team_name": "Tottenham Hotspur",
"away_team": "team_06fhmsvgphy071kc7m1674rarw",
"away_team_name": "Everton",
"kickoff": "2026-09-12T16:30:00Z",
"score": null,
"status": "scheduled"
},
{
"id": "cst_06g6xqzkz5zv3170f8zapp486w",
"edition": "edt_06fvn882fnts705e352sckn954",
"competition": "comp_06fhmsve49s27fwzh4r71vr0p0",
"event": null,
"stage": "regular",
"location": {
"venue_name": "Stadium of Light",
"city": "Sunderland",
"country": "England",
"neutral_site": null
},
"home_team": "team_06fhmsvgsns030e5gd1dzfetwg",
"home_team_name": "Sunderland",
"away_team": "team_06fhmsvgknw33e233vtd3fer98",
"away_team_name": "Arsenal",
"kickoff": "2026-09-12T19:00:00Z",
"score": null,
"status": "scheduled"
},
{
"_truncated": 8
}
]
}| Score pending |
| Coventry Building Society Arena |
| Scheduled |
| Score pending | Old Trafford | Scheduled |
| Score pending | Elland Road | Scheduled |
| Score pending | Gtech Community Stadium | Scheduled |
| Score pending | Tottenham Hotspur Stadium | Scheduled |
| Score pending | American Express Stadium | Scheduled |
| Score pending | Hill Dickinson Stadium | Scheduled |
| Score pending | St. James' Park | Scheduled |
getLeagueSlateForDate('epl', date) across a bounded window -> most-recent-completed + next-scheduled, sorted by kickoff
Free tier, ~21 games-by-date calls across the window (cached ~1h), cache: 1h
GET https://api.statshawk.ai/v1/competitions/epl/editions/{year}/games?date={date} (scanned across the ~3-week matchday window)Visualize a batter-pitcher matchup
Jr. hits .421 up and in and just .219 down and in.
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').
{
"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
}
}
}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)
curl "https://api.statshawk.ai/v1/persons/per_06fhk442hdvh19ga819641j9p8/game-log?competition=mlb&season=2026" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"GET https://api.statshawk.ai/v1/contests/{game}/play-by-play?detail=full&batter_id=per_06fhk442hdvh19ga819641j9p8 (per game in the batter's season log)curl "https://api.statshawk.ai/v1/persons/per_06fhk442hdvh19ga819641j9p8" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"curl "https://api.statshawk.ai/v1/persons/per_06fhk442nhxx131y2z5qbd9ghr" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"curl "https://api.statshawk.ai/v1/persons/per_06fhk442nhxx131y2z5qbd9ghr/game-log?competition=mlb&season=2026&limit=1" \
-H "X-API-Key: sk_live_YOUR_KEY_HERE"GET https://api.statshawk.ai/v1/teams/{team}