European football matches — upcoming games, results, and highlights for briefings.
Track European football matches — upcoming games, live scores, and results.
# Upcoming matches (next 7 days)
{baseDir}/scripts/football.js upcoming
# Today's matches
{baseDir}/scripts/football.js today
# Specific league
{baseDir}/scripts/football.js upcoming --league bundesliga
{baseDir}/scripts/football.js upcoming --league premier-league
{baseDir}/scripts/football.js upcoming --league champions-league
# Interesting matches only (top teams, derbies)
{baseDir}/scripts/football.js highlights
# Results from recent matches
{baseDir}/scripts/football.js results
| League | Code | API |
|---|---|---|
| Bundesliga | bundesliga, bl1 | OpenLigaDB (free) |
| 2. Bundesliga |
bundesliga2, bl2 |
| OpenLigaDB (free) |
| DFB Pokal | dfb | OpenLigaDB (free) |
| Premier League | premier-league, pl | football-data.org |
| La Liga | la-liga, pd | football-data.org |
| Serie A | serie-a, sa | football-data.org |
| Ligue 1 | ligue-1, fl1 | football-data.org |
| Champions League | champions-league, cl | football-data.org |
| Europa League | europa-league, el | football-data.org |
For daily briefings, use:
{baseDir}/scripts/football.js briefing
Returns a compact summary of:
OpenLigaDB (German leagues): No key required! ✅
football-data.org (other leagues): Free tier available
FOOTBALL_DATA_API_KEY environment variableThe highlights command filters for:
# JSON (default)
{baseDir}/scripts/football.js today
# Human-readable
{baseDir}/scripts/football.js today --human
# Compact (for briefings)
{baseDir}/scripts/football.js briefing --compact