Stats included
Every soccer stat field the API returns today — 80 in total, grouped by how they are produced. Each group carries its own freshness, because a sport is rarely uniformly current.
Season player stats
Post-gameWritten after the game ends — not a live in-game feed. Last ingested 2026-08-27.
- Endpoint
- /v1/players/:id/stats
- Last updated
- 2026-08-27
Fields (42)
- Shooting
- Dribbles Attempted, Shots on Target, Shots, Npxg, XG, XG Buildup, XG Chain
- Scoring
- Match Rating, Goals, Npg
- Passing
- Assists, Pass Accuracy, Key Passes, Passes, Xa
- Possession
- Dribbled Past, Dribbles Completed
- Defending
- Duels, Duels Won, Blocks, Interceptions, Tackles
- Goalkeeping
- Goals Conceded, Saves
- Discipline
- Red Cards, Yellow Cards, Second Yellow (red), Fouls Committed, Fouls Drawn, Penalties Conceded, Penalties Missed, Penalties Saved, Penalties Scored, Penalties Won
- Appearances
- Appearances, Starts, Minutes Played, Unused Substitute, Substituted On, Substituted Off, Games, Minutes
Team stats (per game)
Post-gameWritten after the game ends — not a live in-game feed. Last ingested 2026-08-30.
- Endpoint
- /v1/matches/:id/statistics
- Last updated
- 2026-08-30
Fields (38)
- Shooting
- Shot %, Shots on Target, Total Shots
- Scoring
- Final Score, Tournament Topscorers
- Passing
- Accurate Crosses, Accurate Long Balls, Accurate Passes, Cross Accuracy %, Long-Ball Accuracy %, Pass Accuracy %, Total Crosses, Total Long Balls, Total Passes
- Possession
- Momentum, Possession %, Team Form, Team Match Stats, Won Corners
- Defending
- Blocked Shots, Effective Clearances, Effective Tackles, Interceptions (defensive), Tackle %, Total Clearance, Total Tackles
- Goalkeeping
- Saves (goalkeeper)
- Discipline
- Fouls Committed, Offsides, Penalty Goals, Penalty Shots, Red Cards, Yellow Cards
- Appearances
- Average Positions, Best Players, Away Lineup, Home Lineup, Player Match Stats
Not included
- Not shown here — team_per_game_advanced: advanced team stats that no route currently serves.
- Not shown here — injuries: injury reports — reference data with its own endpoint.
Missing a stat?
We build what people actually ask for. If a field you need is not on this page, tell us — requests are how we decide what to add next.
What you can build
Live score widget
Embed real-time EPL scores and goal events on any site.
Matchday companion
Confirmed lineups, formations and live scores side by side with the game.
Fantasy / FPL tool
Per-player season stats (goals, assists, xG) and injury status in one feed.
Betting research tool
Pre-match and in-play odds across major books with against-the-spread splits.
Table tracker
Full Premier League table, refreshed within 60 seconds of a final whistle.
xG analytics dashboard
Player-season xG, xA, npxG and xG chain across twelve seasons, for season-over-season analysis.
Walk through it end to end: How to build a soccer xG app.
Endpoints
On the gateway at api.bigballsdata.com. Authenticate with the bearer token from /dashboard/keys. Click any endpoint to see every field it returns.
6 endpoints · 74 documented fields. Click any row to see every field it returns.
Read live from GET /v1/coverage — the same endpoint you can call yourself. Dates are absolute, not a build timestamp.
Start on the free tier
100 requests per minute and 1,000 per day, free — the highest per-minute burst of any free sports API we checked. Burst is what matters when something asks several questions in a row and waits on each answer.
- Every sport and league we cover — the paid tiers add history depth and premium fields, not more leagues.
- Calls are counted one for one — no credit weighting, no markets-times-regions arithmetic.
- Link GitHub and the daily cap goes to 2,000.
- No credit card.
Or ask your AI tool directly
Connect your account to Claude, ChatGPT, Cursor, Perplexity or any other MCP-compatible tool and ask for soccer data in conversation — scores, standings, player stats and Elo ratings, with no API key to paste and no code to write. Your plan and limits carry over exactly as they do here.
Connect your AI tool →Integrate in a few lines
import { BigBallSportsClient } from '@bigballsdata/sdk';
const client = new BigBallSportsClient(process.env.BBS_API_KEY!);
const matches = await client.matches.list({ sport: 'football', league: 'epl', status: 'live' });
for (const m of matches.data) {
console.log(m.home, m.away, m.scores?.value?.home, '-', m.scores?.value?.away);
}Free covers a real app. Scale when you need to.
1,000 req/day free (2,000 with GitHub). Production starts at $49/mo. Live WebSocket push on Pro+.
Frequently asked
- Is the Premier League API free?
- Yes. All 20 clubs, scores, lineups, stats, standings, and events on the free tier at 1,000 req/day (2,000 with GitHub), no credit card. Odds require the Edge plan ($149/mo) or higher.
- Does it include xG?
- Yes. /v1/stored/matches/:id/stats returns match-level xG and possession; per-player season xG is available via the player stats endpoint where the upstream feed supplies it.
- Are confirmed lineups available?
- Yes. Starting XIs surface in the lineups endpoint, typically around 60 minutes before kickoff, including bench and substitutions.
- Do you cover EPL cup competitions?
- League fixtures are the primary coverage. FA Cup and EFL Cup matches involving Premier League clubs surface through the same endpoints when upstream covers them.
Related APIs
Other APIs you can build with: