⚽ World Cup 2026 — Proxy API

World Cup 2026 fixtures API. Responses are JSON, cached 60s.

Endpoints

• GET /api/matches — all fixtures grouped by day, plus a live array.
• GET /api/live — only currently-live matches (with live minute).
• GET /widget — banner HTML widget for Android/iOS WebView (live or next match).
• GET /widget-list — list widget showing 3 matches (live first, then upcoming).

Banner widget

Full-width banner (≈72px tall), content centered. Team name on top, logo below; live minute above the score. Live match (minute + score) or next match (countdown), auto-rotating. Not clickable. Self-hosted logos (no external requests).

Params: theme=dark|light, accent=RRGGBB, bg=RRGGBB|transparent, idLeague=1056, rotate=6000, logos=1|0. Preview: /widget?mock=live

Embed with an iframe:

<iframe src="https://wc2026-proxy.pages.dev/widget"
        style="width:100%;height:72px;border:0;display:block"
        scrolling="no"></iframe>

List widget

Vertical list of 3 matches (live first, then upcoming). Params: theme, accent, bg, idLeague, count (1–8, default 3), logos. Preview: /widget-list?mock=live

<iframe src="https://wc2026-proxy.pages.dev/widget-list"
        style="width:100%;height:100px;border:0;display:block"
        scrolling="no"></iframe>

Query params

• idLeague — league id (default 1056 = WC 2026; use live for the global live page).
• next, matchesListed — pagination pass-through (matches only).