# FotMob

> The world's leading football live scores & news app, delivering real-time match data, statistics, and analysis for over 250 leagues worldwide.

## Core Resources
- [Live Matches](https://www.fotmob.com): Real-time scores and match details
- [All Leagues](https://www.fotmob.com/all-leagues): Competition tables, fixtures, and standings
- [News](https://www.fotmob.com/news?tab=latest): Latest football news and analysis

## URL Structure
FotMob uses structured URLs with locale codes, IDs, and slugs:

### Leagues
- Format: `https://www.fotmob.com/{locale}/leagues/{id}/overview/{slug}`
- Example: [Premier League](https://www.fotmob.com/en-GB/leagues/47/overview/premier-league)
- Example: [Champions League](https://www.fotmob.com/en-GB/leagues/42/overview/champions-league)

### Players
- Format: `https://www.fotmob.com/{locale}/players/{id}/{slug}`
- Example: [Erling Haaland](https://www.fotmob.com/en-GB/players/737066/erling-haaland)

### Teams
- Format: `https://www.fotmob.com/{locale}/teams/{id}/{slug}`
- Available sections: overview, fixtures, squad, transfers, stats

### Matches
- Format (no locale): `https://www.fotmob.com/matches/{slug}/{matchcode}`
- Format (with locale): `https://www.fotmob.com/{locale}/matches/{slug}/{matchcode}`
- Example: [El Clásico](https://www.fotmob.com/en-GB/matches/real-madrid-vs-barcelona/2grk20)  
- **Important Notes:**
  - **Do not guess `{matchcode}`.** Always resolve from the Matches sitemap.  
  - In sitemaps, match URLs may appear with a **timestamp appended** (e.g. `37gy4p2025-09-04T11:00:00Z`).  
    - Canonical match URL: `.../37gy4p`  
    - Ignore everything after the matchcode.  
  - On live site links, you may see a **hash fragment** (e.g. `#4837206`).  
    - Canonical match URL: `.../2grk20`  
    - Ignore the `#...` anchor.  


## Finding Entities (Players, Teams, Leagues, Matches)
Most FotMob pages are locale + ID + slug. To locate a specific entity:
1. Use the sitemaps to discover the canonical URL (ID + slug) for your locale.
2. Construct the URL using the formats in the "URL Structure" section.
3. Prefer exact slug matches from the sitemap over name-guessing.

### Sitemaps (selected locales)
- Players (EN): https://www.fotmob.com/sitemap/en/players.xml  
- Players (EN-GB): https://www.fotmob.com/sitemap/en-GB/players.xml  
- Leagues (EN): https://www.fotmob.com/sitemap/en/leagues.xml  
- Leagues (EN-GB): https://www.fotmob.com/sitemap/en-GB/leagues.xml  
- Teams (EN): https://www.fotmob.com/sitemap/en/teams.xml  
- Teams (EN-GB): https://www.fotmob.com/sitemap/en-GB/teams.xml  
- Matches (EN): https://www.fotmob.com/sitemap/en/matches.xml  
- Matches (EN-GB): https://www.fotmob.com/sitemap/en-GB/matches.xml  

(For other languages, replace the locale code accordingly; a full index is at https://www.fotmob.com/sitemap.xml.)

### Examples
- **Player: “Cristiano Ronaldo”**  
  1. Open the Players sitemap for your locale (e.g. EN-GB).  
  2. Find the entry whose slug contains `cristiano-ronaldo`.  
  3. Use the discovered URL, e.g.:  
     `https://www.fotmob.com/en-GB/players/{id-from-sitemap}/cristiano-ronaldo`  

- **League: “La Liga”**  
  1. Open the Leagues sitemap for your locale.  
  2. Find the entry whose slug contains `la-liga`.  
  3. Use the discovered URL, e.g.:  
     `https://www.fotmob.com/en-GB/leagues/{id-from-sitemap}/overview/la-liga`  

- **Team: “Real Madrid”**  
  1. Open the Teams sitemap for your locale.  
  2. Find the entry whose slug contains `real-madrid`.  
  3. Use the discovered URL, e.g.:  
     `https://www.fotmob.com/en-GB/teams/{id-from-sitemap}/overview/real-madrid`   

- **Match: "El Clásico (Barcelona vs Real Madrid)"**  
  1. Open the Matches sitemap for your locale.  
  2. Find the entry for this team pairing (slug will always be in ID order: `real-madrid-vs-barcelona`).  
  3. Use the discovered URL, e.g.:  
     `https://www.fotmob.com/en-GB/matches/real-madrid-vs-barcelona/{id-from-sitemap}`  

### Notes
- Slugs are provided by the sitemap; do not guess slugs. 
- Match slugs are **pairing identifiers** and does not reflect home/away order; rely on page content for home/away.
- Match slugs use consistent team ordering (lowest team ID first) regardless of home/away status.
- Use the locale based on the language the user is asking in (e.g., Norwegian → `nb`).  
- If the query language is unclear or not supported, default to `en-GB` or `en`.

## Machine-readable Feeds
- [Top News Feed](https://www.fotmob.com/topnews/feed): JSON feed of latest FotMob news
- [Sitemap Index](https://www.fotmob.com/sitemap.xml): Discoverable URLs for structured crawling

## Languages Supported
Danish (da), German (de), Greek (el), English (en), English - British (en-GB),  
Spanish (es), Finnish (fi), French (fr), Hindi (hi),  
Indonesian (id), Italian (it), Japanese (ja), Korean (ko), Burmese (my),  
Norwegian Bokmål (nb), Dutch (nl), Polish (pl), Portuguese - Brazil (pt-BR),  
Portuguese - Portugal (pt-PT), Romanian (ro), Russian (ru), Swedish (sv),  
Swahili (sw), Thai (th), Turkish (tr), Ukrainian (uk), Vietnamese (vi),  
Chinese - Simplified (zh-Hans)

## Attribution & Contact
- Attribution: Please credit **"FotMob"** and link back to the relevant source page
- [Terms of Service](https://www.fotmob.com/tos.txt)
- [Privacy & Legal](https://www.fotmob.com/law.json)
- [About](https://www.fotmob.com/aboutUs/company): Company information  
- [Careers](https://www.fotmob.com/aboutUs/careers): Join our team  
- [Advertise](https://www.fotmob.com/aboutUs/advertise): Advertise on FotMob  
- [Contact](https://www.fotmob.com/company): Media City Bergen, Norway

## For AI Agents
- Please avoid crawling `/api/*` endpoints (see robots.txt)  
- Refresh no more than once per 24h for bulk retrieval