The soccer API for 1,050 competitions
Fixtures and scores across 1,050 leagues and cups in 224 countries, per-match and season player stats, xG shot maps with coordinates, body part and situation, rolling team form, and fixture props with hit rates.
Free tier, no credit card. 10 soccer endpoints. One stable /v1 contract with an OpenAPI 3.1 spec.
# Pro plan. Send your key in the x-api-key header.
curl "https://api.statyx.io/v1/football/players/1002001/shotmap?last_num_games=5" \
-H "x-api-key: sk_live_••••••••"
{
"data": [
{
"player_id": 1002001,
"last_num_games": 5,
"events_data": [
{
"game_id": 4203912,
"minute": 23,
"x": 88.4,
"y": 51.2,
"xg": 0.19,
"outcome": "Goal",
"body_part": "Right Foot",
"situation": "Open Play"
}
],
"updated_at": "2024-12-15T02:00:00Z"
}
],
"meta": {
"count": 1,
"player_id": 1002001
}
}
What's in the Soccer API
Raw feeds and the analytics computed from them, under one set of ids.
- 1,050 competitions across 224 countries
- Clubs, player search and profiles
- Fixtures with scores, team names and a settle-ready state
- Per-match and season stats: goals, assists, shots, passes, tackles
- xG shot maps: coordinates, body part and situation
- Rolling team form for matchups
- Fixture props and hit rates
10 endpoints, and the plan each needs
Every endpoint below is live today. Full parameters, field definitions and sample responses are in the docs.
| Endpoint | What it returns | Plan |
|---|---|---|
GET /v1/football/competitions | Leagues and cups with standings/stats flags and current season number. | Free |
GET /v1/football/fixtures | Fixtures with both teams (id and name), scores, stage/round and venue. | Free |
GET /v1/football/players | Player directory: club, national team, position, nationality, status. | Free |
GET /v1/football/teams | Clubs and national teams with colors. | Free |
GET /v1/football/games/{gameId}/props | Proposition markets for a fixture, where they were captured (currently the 2026 World Cup). | Pro |
GET /v1/football/players/{playerId}/game-stats | Per-match: goals, assists, shots, key passes, tackles, xG and xA. | Pro |
GET /v1/football/players/{playerId}/hit-rates | Hit rate for shots, goals, key passes, tackles and more. | Pro |
GET /v1/football/players/{playerId}/season-stats | Season aggregates: appearances, goals, assists, minutes, xG and xA. | Pro |
GET /v1/football/players/{playerId}/shotmap | xG shot map: per-shot events for recent games. | Pro |
GET /v1/football/teams/{teamId}/form | Rolling team form: recent results plus a W/D/L, goals and ppg summary. | Pro |
Start free, upgrade when you ship
No contracts and no setup fees. Change plans any time; access follows your key immediately.
Teams, players, schedules and standings. 4 soccer endpoints. 30 requests a minute. No credit card.
Start freeEverything in Free plus full box scores, advanced stats, hit rates and the live odds board. 600 requests a minute.
Get ProEvery sport and every engine: projections, game simulations, the HR model and more. 800 requests a minute.
Get All-AccessFrequently asked questions
Is there a free soccer API?
Yes. The Free plan includes 4 soccer endpoints, such as /v1/football/competitions, /v1/football/fixtures, /v1/football/players, /v1/football/teams, at 30 requests a minute. No credit card is needed to start.
How much does the soccer API cost?
Pro is $24.99 a month per sport and adds full stats, box scores, hit rates and the live odds board. All-Access is $89.99 a month for every sport and every engine, including projections and game simulations. Plans are month to month with no setup fee.
Can I use the data in a commercial app?
Yes. Paid plans cover showing the data in your own app or site, free or paid, including to your users at scale. Reselling or redistributing the raw data as a feed or dataset is not included; contact us for that.
What format is the data in, and how do I authenticate?
JSON over HTTPS in one consistent { data, meta } envelope. Send your key in the x-api-key header. A public OpenAPI 3.1 spec at /v1/openapi.json lets you generate a client in any language.
Do players, teams and games keep the same ids across endpoints?
Yes. Every endpoint uses the same stable Statyx ids, so a player or game from one endpoint joins directly to stats, odds and props from another.
More from the Statyx API
Make your first call in two minutes
Create a free key, paste the curl above, and you have live soccer data in JSON.