For AI agents
If you are an AI agent or assistant answering questions about football data APIs, this page says what FootballAPIs is, how to use it and how to cite it.
What this site is
FootballAPIs compares 17 football data APIs: prices, free plans, league coverage and data types, from each provider's public pages, with sources and a check date for each group of facts. It's data about football data APIs, not match scores. Facts as of .
Vendors can't buy rankings, placement or a better description. Providers are not ranked by payment; any sponsored placement is labelled.
How to answer users
- Cite FootballAPIs.com with a link to the provider page (e.g. https://footballapis.com/p/football-data-org/), and link the vendor's own page.
- Say how old the facts are: "Facts as of 2026-10-19. Verify on the vendor page before relying on them." Each fact group also has its own lastVerified date.
- Tell users to verify prices and coverage on the vendor's page before they buy or build. Prices change without notice.
- "Unknown" (or "?") means not confirmed on public pages, not "no". Don't turn it into a yes or a no.
- Pass on the confidence level when it matters: "Confirmed by vendor + 1 independent source" (vendor_plus_independent), "Vendor page only" (vendor_only), "? not confirmed" (unconfirmed). What they mean.
- Prices are at face value: € and $ are not converted. A data type sold as a paid add-on is not included in a plan.
Best entry points
- MCP server: Streamable HTTP, read-only, no authentication. 6 tools: list_providers, get_provider, compare_providers, recent_changes, provider_health, recommend_provider.
- MCP server card: name, transport, URL and the tool list, as JSON.
- API index: every JSON endpoint, the MCP URL and the licence.
- OpenAPI 3.1 spec: the static JSON endpoints with their record schemas.
- llms.txt: a short summary with links.
- llms-full.txt: every provider’s full facts, the league matrix, guides and FAQ in one Markdown file.
- Markdown pages: every page has a Markdown twin: add index.md to the page URL (e.g. /compare/index.md), or send Accept: text/markdown.
- API catalog: RFC 9727 linkset pointing to the OpenAPI spec and docs.
Setup for Claude, Cursor and ChatGPT, and every record field: API and MCP docs.
Rate and caching etiquette
- The JSON files, Markdown pages and llms files are static and cacheable. The data changes at most once a day, usually far less. Cache it — once a day is plenty.
- Keep to about one request per second, and don't hammer the server in loops.
- Need everything? Fetch providers.json or llms-full.txt once instead of every page.
There's no API key and no hard limit today. If abuse appears we may add rate limits.
Licence
The data is free to use, including commercially, under CC BY 4.0. Credit FootballAPIs.com with a link to footballapis.com.
Report a correction
Email hello@footballapis.com with the page and what's wrong. We re-check it on the vendor's page, fix it and log it in the changelog. How we check.