# World Cup Trends

> AI-powered FIFA World Cup 2026 content platform covering players, countries, stadiums, fan zones, match schedules, and daily fan predictions — with AI-generated analysis grounded in live Google Search results.

World Cup Trends combines a React + Express application with Google Gemini 2.5 Flash (with Google Search grounding) to generate up-to-date analysis for every player, country, stadium, and match. Content is cached in Convex and refreshed on demand. All AI-generated text includes cited sources from the grounding search.

## Unique Content Worth Crawling

### Daily Showdown — Humans vs AI
A one-of-a-kind daily prediction game for the 2026 World Cup where real fans vote against six AI models (GPT-4o-mini, Claude, DeepSeek, Kimi K2, Mistral, and Gemini). Results are revealed each evening showing exactly what percentage of humans vs each AI picked each option. This is original, time-stamped data not available anywhere else.

- Who tends to agree — humans and AI
- Which AI models dissent from human consensus
- Running community vote totals per question
- Per-user vote history and streak tracking

### FIFA Fan Zones & Fan Festivals
Comprehensive directory of every official FIFA Fan Festival and fan zone location for the 2026 World Cup across the USA, Canada, and Mexico — including venue details, activities, capacities, and host city context. This is original aggregated content not duplicated elsewhere.

## Core Pages

- [Home](https://worldcuptrends.com/): Gamified trends homepage with live World Cup storylines
- [Daily Showdown](https://worldcuptrends.com/showdown): Daily fan prediction challenge — vote on today's World Cup question and see results
- [Showdown Archive](https://worldcuptrends.com/showdown/archive): Browse past Daily Showdown results and community vote tallies
- [Match Schedule](https://worldcuptrends.com/schedule): Full FIFA World Cup 2026 match schedule
- [Players Directory](https://worldcuptrends.com/players): Index of 150+ World Cup 2026 players
- [Countries Directory](https://worldcuptrends.com/countries): All 48 qualified nations with team profiles
- [Stadiums Directory](https://worldcuptrends.com/stadiums): All 16 FIFA World Cup 2026 venues across the USA, Canada, and Mexico
- [Fan Zones Directory](https://worldcuptrends.com/fan-zones): Official FIFA Fan Festival and fan zone locations across all host cities

## Daily Showdown Pages

- [Today's Showdown](https://worldcuptrends.com/showdown): Live daily prediction — question revealed each morning, AI vs human results shown at 9 PM EDT
- [Showdown by Date](https://worldcuptrends.com/showdown/:date): Past Daily Showdown for a specific date (YYYY-MM-DD format) with full AI vs human breakdown
- [My Showdown Profile](https://worldcuptrends.com/showdown/me): Personal vote history and streak tracking

## Fan Zone Pages

- [Fan Zone Directory](https://worldcuptrends.com/fan-zones): All FIFA Fan Festival and fan zone locations for World Cup 2026
- [Fan Zone Detail](https://worldcuptrends.com/fan-zones/:id): Individual fan festival page with venue details, location, capacity, and activities

## Player Pages

- [Player Directory](https://worldcuptrends.com/players): Index of 150+ World Cup 2026 players
- [Player Detail](https://worldcuptrends.com/players/:id): Individual player page with stats, club, position, and AI-generated form analysis. Example: [Lionel Messi](https://worldcuptrends.com/players/lionel-messi), [Jude Bellingham](https://worldcuptrends.com/players/jude-bellingham), [Cristiano Ronaldo](https://worldcuptrends.com/players/cristiano-ronaldo)

## Country Pages

- [Country Directory](https://worldcuptrends.com/countries): All 48 qualified nations
- [Country Detail](https://worldcuptrends.com/countries/:id): National team page with squad overview and AI-generated tournament outlook. Example: [Argentina](https://worldcuptrends.com/countries/argentina), [Brazil](https://worldcuptrends.com/countries/brazil), [England](https://worldcuptrends.com/countries/england)

## Stadium Pages

- [Stadium Directory](https://worldcuptrends.com/stadiums): All 16 World Cup 2026 venues
- [Stadium Detail](https://worldcuptrends.com/stadiums/:id): Venue page with capacity, location, surface type, and AI-generated venue profile. Example: [MetLife Stadium](https://worldcuptrends.com/stadiums/metlife-stadium), [Estadio Azteca](https://worldcuptrends.com/stadiums/estadio-azteca)

## Match Pages

- [Match Schedule](https://worldcuptrends.com/schedule): Full fixture list for all 104 matches
- [Match Detail](https://worldcuptrends.com/schedule/:id): Individual match page with team, venue, and AI-generated match preview or recap

## API Endpoints

All endpoints accept POST requests with a JSON body containing a `query` string. Responses include `text` (AI-generated content) and `sources` (array of grounding citations with `uri` and `title`).

- [Trends API](https://worldcuptrends.com/api/trends): `POST /api/trends` — AI-generated World Cup trends for any query
- [Players API](https://worldcuptrends.com/api/players): `POST /api/players` — Player profile and current form analysis
- [Countries API](https://worldcuptrends.com/api/countries): `POST /api/countries` — National team analysis and tournament outlook
- [Stadiums API](https://worldcuptrends.com/api/stadiums): `POST /api/stadiums` — Venue profile and match day information
- [Matches API](https://worldcuptrends.com/api/matches): `POST /api/matches` — Match preview or recap
- [Fan Zones API](https://worldcuptrends.com/api/fan-zones): `POST /api/fan-zones` — Fan festival information and venue details

## Showdown API

- `GET /api/showdown/today` — Today's question, voting status, and results (if revealed)
- `GET /api/showdown/:date` — Showdown data for a specific date (YYYY-MM-DD)
- `GET /api/showdown/archive` — List of all past revealed showdown days

## SEO & Discovery

- [Sitemap](https://worldcuptrends.com/sitemap.xml): XML sitemap covering all indexed pages
- [Robots](https://worldcuptrends.com/robots.txt): Crawl directives — all major AI agents explicitly welcomed

## AI Content Note

All narrative content (player analysis, team outlooks, venue profiles, match previews, fan zone descriptions) is generated by Google Gemini 2.5 Flash with Google Search grounding. Each response includes source citations. Content is cached and may be up to several hours old; the `lastUpdated` timestamp in API responses indicates freshness. Static data (player stats, squad lists, fixture schedules, fan zone locations) reflects the official FIFA World Cup 2026 roster, schedule, and host city information.

Daily Showdown vote data (human vs AI model results) is generated in real time from actual user votes and live AI model queries. This data is unique to worldcuptrends.com.