rankings feed
A plain, public JSON file with the same excitement rankings shown on the homepage. No scores, no auth, no rate limiting beyond normal caching. Fetch it from any app.
endpoint
/rankings.jsonexample response
{
"competition": "Premier League 2026-27",
"lastUpdated": "2026-08-15T20:05:00.000Z",
"rankings": [
{
"rank": 1,
"id": "123456",
"homeTeam": "Arsenal FC",
"awayTeam": "Chelsea FC",
"date": "2026-08-15T15:00:00Z",
"matchday": "Matchday 3",
"excitementScore": 94,
"excitementLevel": "legendary",
"hasLateGoals": true,
"isUpset": false,
"watchUrl": "https://your-app.vercel.app/watch/match-1",
"streamUrl": "https://your-app.vercel.app/api/stream/match-1"
}
]
}notes
- Refreshes about once a minute; safe to poll.
- CORS-enabled, so browser apps on other domains can fetch it directly.
- Sorted by excitementScore, highest first. No goal totals or winners are included.
watchUrllinks to this app's watch page for a match; use it for a browsable link.streamUrlis a direct, playable video URL for a<video>tag or player embed. Both arenullwhen a match has no video yet.