Free public API · cache-friendly · attribution requested

Build your own World Cup 2026 widget.

Use the free World Cup 2026 Tour JSON API for blogs, school club pages, pub watch-party pages, Discord bots, small fan tools, and AI agents. It returns static schedule data with optional local-time conversion.

Open metadata JSON OpenAPI spec AI manifest All matches JSON Use no-code widget

Endpoints

/api/public/v1/metadataAPI metadata, schema notes, and recommended attribution./datasetCiteable dataset landing page with JSON-LD, OpenAPI, RSS, and calendar distributions./dataset.jsonMachine-readable Dataset JSON-LD plus all 104 public fixtures in UTC.https://huggingface.co/datasets/abaiii168/world-cup-2026-tour-match-schedulePublic Hugging Face mirror for dataset discovery by AI and data communities.https://www.kaggle.com/datasets/ayworldcup2026/world-cup-2026-tour-match-schedulePublic Kaggle dataset mirror for data-community discovery./openapi.jsonOpenAPI 3.1 specification for the free public schedule API./.well-known/ai-plugin.jsonAI-readable manifest pointing to the OpenAPI specification.https://github.com/abaiii168/world-cup-2026-mcp-serverFree MCP server repo for AI agents using the schedule as tools.https://raw.githubusercontent.com/abaiii168/world-cup-2026-mcp-server/main/server.jsonOfficial MCP Registry-ready server.json metadata for the free schedule MCP server./oembed?url=https%3A%2F%2Fay-worldcup2026.zeabur.app%2FwidgetoEmbed endpoint for automatic rich embeds in CMS and blog tools./shields/next-match.json?city=tokyoShields.io dynamic endpoint for GitHub README badges./api/public/v1/matches?timezone=Europe/LondonAll 104 static World Cup 2026 matches, converted to an optional IANA time zone./api/public/v1/matches/{id}?timezone=Asia/TokyoOne static match by id./api/public/v1/next?timezone=America/New_YorkThe nearest upcoming static match relative to the server clock.

Example

https://ay-worldcup2026.zeabur.app/api/public/v1/next?timezone=Europe/London

fetch("https://ay-worldcup2026.zeabur.app/api/public/v1/next?timezone=Europe/London")
  .then((response) => response.json())
  .then((data) => {
    console.log(data.match.home.name, "vs", data.match.away.name);
    console.log(data.match.kickoff.requestedLocalTime);
  });

Use It Kindly

Cache responses

Responses are cacheable for 1 hour. Avoid polling faster than necessary.

Link back

Please include a link to World Cup 2026 Tour when your tool uses this free API.

Static schedule

This public API exposes static schedule data. Live scores and odds remain separate app features.

No API key is required. This page and API do not accept user-submitted HTML or remote URLs.