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.

Endpoints

/api/public/v1/metadataAPI metadata, schema notes, and recommended attribution./api/public/v1/embed-pack?timezone=Europe/LondonCopy-ready attributed API, widget, team schedule, and dataset snippets for external READMEs, blogs, widgets, fan tools, and AI/data projects./api/public/v1/matches/{id}/shareCopy-ready share links with public_api/developer_referral attribution for developer-built widgets and README/blog embeds./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://huggingface.co/spaces/abaiii168/world-cup-2026-ai-predictionsPublic Hugging Face Space for AI prediction feature 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.https://github.com/abaiii168/world-cup-2026-local-time-resource-packPublic README/blog/API resource pack with attributed API examples, share-pack links, and AI group-chat challenge copy.https://abaiii168.github.io/world-cup-2026-local-time-resource-pack/GitHub Pages version of the public resource pack for quick human and AI-readable discovery.https://abaiii168.github.io/world-cup-2026-local-time-resource-pack/llms.txtAI-readable llms.txt for the public resource pack.https://gist.github.com/abaiii168/f165889ce72654e6387b6777937a82c3Short public Gist resource pack with current next-match API, share-pack, widget, and AI prediction links.https://registry.modelcontextprotocol.io/v0/servers?search=io.github.abaiii168/world-cup-2026Official MCP Registry listing for AI-agent discovery of the free World Cup 2026 MCP server.https://raw.githubusercontent.com/abaiii168/world-cup-2026-mcp-server/main/glama.jsonGlama MCP metadata file for registry auto-indexing quality./.well-known/mcp/server-card.jsonStatic MCP server card for Smithery and MCP-directory scanners when live protocol scanning is unavailable.https://lobehub.com/mcp/abaiii168-world-cup-2026-mcp-serverLobeHub MCP directory listing for AI-agent discovery of the free World Cup 2026 MCP server./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/today?timezone=America/New_YorkToday-focused match heat pack for AI/search agents, including canonical match links, live-score entries, calendar links, share packs, and citation fields./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&utm_source=developers&utm_medium=copy&utm_campaign=wc26_public_api&utm_content=api_endpoint

fetch("https://ay-worldcup2026.zeabur.app/api/public/v1/next?timezone=Europe/London&utm_source=developers&utm_medium=copy&utm_campaign=wc26_public_api&utm_content=api_endpoint")
  .then((response) => response.json())
  .then((data) => {
    console.log(data.match.home.name, "vs", data.match.away.name);
    console.log(data.match.kickoff.requestedLocalTime);
  });
Open widget page
<div data-wc26-next-match></div>
<script async src="https://ay-worldcup2026.zeabur.app/embed/world-cup-2026.js?utm_source=developers&utm_medium=copy&utm_campaign=wc26_public_api&utm_content=widget_embed"></script>

Attribution Pack For READMEs And Blogs

This pack is the preferred copy source for external websites, READMEs, directories, and AI/data tools because every link keeps measurable attribution back to the developer loop.

World Cup 2026 developer embed pack:
https://ay-worldcup2026.zeabur.app/api/public/v1/embed-pack?timezone=Europe%2FLondon&utm_source=developer_referral&utm_medium=embed_pack&utm_campaign=wc26_tbd_tbd_developer_embed&utm_content=developer_embed_pack

Widget:
<div data-wc26-next-match></div>
<script async src="https://ay-worldcup2026.zeabur.app/embed/world-cup-2026.js?utm_source=developer_referral&utm_medium=embed_widget&utm_campaign=wc26_tbd_tbd_developer_embed&utm_content=copied_widget"></script>

Team schedule JSON:
https://ay-worldcup2026.zeabur.app/team/algeria.json?utm_source=developer_referral&utm_medium=embed_pack&utm_campaign=wc26_tbd_tbd_developer_embed&utm_content=developer_embed_pack

Team schedule dataset:
https://ay-worldcup2026.zeabur.app/dataset/team-schedules.csv?utm_source=developer_referral&utm_medium=embed_pack&utm_campaign=wc26_tbd_tbd_developer_embed&utm_content=developer_embed_pack

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.