FootballHub
API Setup Guide
Connect live 2025/26 season data from API-Football to your FootballHub site in 4 steps. Free plan covers all Top 5 European leagues.
Free Tier — No credit card required
API-Football's free plan includes 100 requests/day across all endpoints. With the caching strategy built into FootballHub, this comfortably supports all 5 league standings, fixtures, top scorers, and live scores for normal traffic.
Register free account →Register for a free API key
Go to dashboard.api-football.com/register and create a free account. No credit card required. The free plan gives you 100 requests per day, which covers all standings, fixtures, and stats with smart caching.
Copy your API key
After registering, go to your dashboard and copy the key shown under My Applications → API Key. It looks like a 32-character alphanumeric string. Keep it secret — do not commit it to Git.
Add the key to Vercel
In your Vercel project: Settings → Environment Variables → Add New. Set:API_FOOTBALL_KEY = <your key here>Make sure it is added to all environments (Production, Preview, Development). Then trigger a new deployment.
Verify the connection
After deploying, visit /api/debug/football — it shows your account status, remaining daily requests, and a live test of the standings endpoint. If it shows ok: true with results > 0, all data will appear within 60 seconds.
Endpoints used & caching
/standings12 hours5/dayLeague tables for all 5 leagues/fixtures5 minutes~10/dayFixtures by date + league/fixtures?live=all2 minutes~30/dayLive match scores & status/players/topscorers12 hours5/dayTop goalscorers per league/players/topassists12 hours5/dayTop assists per league/teams24 hours5/dayAll clubs per leagueTotal: ~60 API calls/day with normal traffic — well within the 100/day free limit.
League IDs (2025/26 season)
league=39&season=2025league=140&season=2025league=78&season=2025league=135&season=2025league=61&season=2025