OpenFoot API
A developer-first football data API combining current German data, Romanian and expanded European league datasets, open archives and derived analytics.…
Data & analytics#sports--fitness
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
A developer-first football data API combining current German data, Romanian and expanded European league datasets, open archives and derived analytics. Coverage, season metadata and source licenses are explicit; an uptime SLA is not included in this beta.
Endpoints 20
System
- GETCheck API health
/v1/health
Competitions
- GETList supported competitions
/v1/competitions - GETGet league standings table
/v1/standings?competition=comp_bundesliga_deReturns the league table with total, home, and away splits, goal difference, points and recent form. - GETGet league top scorers and leader statistics
/v1/scorers?competition=comp_premier_league_engReturns the league's confirmed top scorers, goal tallies, assists, player identity, and club information.
Matches
- GETList fixtures and results
/v1/matchesThe public preview returns at most five matches. Developer access supports cursor pagination with up to 100 matches per page. A query with no competition,… - GETGet derived match context
/v1/matches/:id/contextReturns both teams' form, Elo-style rating, rest, table position, venue record, head-to-head and field freshness. The public preview ID is match_olg_83156;… - GETGet live key events and commentary timeline
/v1/matches/:id/eventsGoals, cards and substitutions for one match. Each event names the player it happened to in player — the scorer, the booked player, or the one coming on.… - GETGet starting XI, bench and tactical formations
/v1/matches/:id/lineups
Live
- GETStream live match ticks, goal alerts, and status changes (SSE)
/v1/live/streamServer-Sent Events (SSE) persistent stream. Emits instant 'goal', 'status_change', and periodic 'tick' updates. Accepts API key in Authorization header,… - GETList registered webhook endpoints
/v1/webhooks - POSTRegister a webhook endpoint for live match events
/v1/webhooksRegisters an HTTPS endpoint to receive match.goal, match.kickoff, match.halftime, match.fulltime, and match.status_change events signed with HMAC SHA-256. - DELETEDelete a registered webhook
/v1/webhooks?id=string - POSTSend a test ping to a webhook
/v1/webhooks/test
Search
- GETSearch teams and competitions
/v1/search?q=bayernThe public preview returns at most five search results.
Account
- GETInspect monthly quota without consuming requests
/v1/account/quotaReturns current billing-period usage for the supplied API key. Read-only: never consumes monthly quota.
Teams
- GETGet team squad roster
/v1/teams/:id/squadReturns the team's official squad roster with player names, shirt numbers, positions, nationalities, age, and season statistics. - GETGet head-to-head match history between two teams
/v1/teams/:id/h2h?opponent=team_chelsea_engReturns historical head-to-head records, win/draw/loss counts, goal metrics, and recent meeting results between two clubs.
Analytics
- GETGet granular shot maps and expected goals (xG) per shot
/v1/matches/:id/xgReturns the shots the upstream source publishes for the match, with no shots added, removed or estimated. There is no per-match completeness field. A match… - GETGet league-wide expected goals table
/v1/analytics/xgPer-team Expected Goals, xG conceded and xG difference for any competition whose data source publishes an xG table. Defaults to the current season; pass…
Odds
- GETGet bookmaker odds benchmark and implied fair probabilities
/v1/odds?matchId=match_olg_83156
API details
- Base URL
https://openfootapi.com- Authentication
- A bearer token in the Authorization header
- Operations
- 20 operations on 18 pathsGET 17POST 2DELETE 1
- Main resources
- Live 5Matches 4Competitions 3Analytics 2Teams 2Account 1Odds 1Search 1System 1
- Response formats
application/jsontext/event-stream- Description format
- OpenAPI 3.1.0, API version
1.0.0-beta - Links
- OpenAPI document
- Listed from
- Openfootapi's published OpenAPI description
How to test the OpenFoot API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the OpenFoot API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Check API health” (GET /v1/health), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the OpenFoot API?
A developer-first football data API combining current German data, Romanian and expanded European league datasets, open archives and derived analytics.… It is listed under Data & analytics and has 20 endpoints.
Who publishes the OpenFoot API?
It is listed from OpenFoot API's public API description (an OpenAPI document), not published by OpenFoot API on Swastik Codes. Anyone who controls openfootapi.com can claim the profile by adding a DNS TXT record.
What is the base URL of the OpenFoot API?
Requests go to https://openfootapi.com. Endpoint paths are added to this base URL.
How do I authenticate with the OpenFoot API?
With A bearer token in the Authorization header.
How many endpoints does the OpenFoot API have?
20 operations on 18 paths (17 GET, 2 POST, 1 DELETE). The largest groups are Live, Matches, Competitions, Analytics.
Is forking the OpenFoot API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.