What's an API key and how do I get one?
A plain-English explainer for anyone building a football app with an AI tool — no coding background needed.
What's an API?
An API is like a menu your app orders data from. Your app sends a request — for example 'today's Premier League matches' — and the provider's server sends back the data, usually as JSON (structured text your code can read).
Football data APIs sell (or give away) access to fixtures, scores, lineups, player stats and more. Your AI coding tool writes the code that places the orders.
What's an API key?
An API key is a long password that identifies you to the provider. Every request your app sends includes it, so the provider knows who is asking, which plan you are on, and how much of your allowance you have used.
How to get one
- Sign up on the provider's own website (each provider page here links to it).
- Find the key in your account dashboard. It may be called an API key, token or access key.
- Store it as a secret. Paste it into your tool's secrets or environment variables (for example a
.envfile that isn't shared, or the secrets / environment settings of your hosting or AI app builder). Don't paste it into the chat, and never put it in public code or front-end code. - Tell your AI tool the name of the variable (e.g.
FOOTBALL_API_KEY), not the key itself.
Rate limits, explained
A rate limit is how many requests you can make in a period of time. Some real free-plan limits from our data:
- API-Football (API-Sports): 100 requests/day
- football-data.org: 10 calls/min
- SportDevs: up to 300 requests/day
If your app asks for fresh data every time someone opens it, a busy day can use up a daily limit quickly. Ask your AI tool to cache responses — save each answer for a few minutes and reuse it.
Why keep it secret?
Anyone who has your key can use it as if they were you: they can use up your free quota, or run up usage on your paid plan. Code that runs in the browser can be read by anyone, so the key must live on a server or in a server-side function, loaded from an environment variable.
What if it leaks?
Go to the provider's dashboard and regenerate (or revoke) the key straight away, then update it in your environment variables. The old key stops working, so whoever found it can't use it any more.
Free trial vs free plan
A free plan is free for as long as you stay within its limits. A free trial gives you access for a limited time — after that you have to pay or stop. For example, Goalserve (30 days) and Entity Sports (15 days) offer trials, while API-Football (API-Sports) has a free plan. Of the 17 providers we track, 9 list a free plan and 6 offer a trial only.
Use the "Free access" filter on the Compare page to see which is which.
Next steps
Pick a guide for what you're building, open a provider page and copy its Build with AI prompt.