FotMob

Search

Search FotMob for teams, players, and leagues by name. Returns matching entities with their FotMob ids, grouped into `teams`, `players`, and `leagues`. Use this first to resolve a name into the id that the `team`, `player`, and `league` tools require.

Matches by date

List football matches on a date across all competitions: scores, kickoff times, and status. Returns each match with its FotMob `id` (pass it to `match_details` for lineups/events/stats). Date is YYYY-MM-DD or YYYYMMDD; omit for today. A single date spans hundreds of matches worldwide and the list is capped, so when you want a specific game ALWAYS pass `team` (e.g. 'Argentina') or `competition` (e.g. 'World Cup') to filter to it rather than scanning the full list.

Match details

Get detail for a single match by its FotMob match id: final or live score and goal/card events. Lineups and detailed team/player stats are large and omitted by default: pass include=['lineup','stats'] only when you actually need them (e.g. a tactical writeup), not to read a scoreline. Get the match id from `matches_by_date` first.

Match prediction

Get FotMob's prediction for a single match by its FotMob match id: the 'Who will win?' poll questions (with FotMob's option labels and supporting form/stat facts), plus FotMob's per-team match insights. Use this for 'what does FotMob predict / who does FotMob favour / what are the picks' on a fixture. Get the match id from `matches_by_date` first. Note: FotMob publishes its own prediction framing and talking points here, not a tally of how users voted.

League

Get a league/competition by its FotMob id: the current table (rank, played, W/D/L, goals, points) plus season info. Resolve the league id with `search` first (e.g. Premier League, La Liga, Champions League).

Team

Get a team by its FotMob id: identity, country, and full squad (player names, positions, and ids for `player`). Resolve the team id with `search` first.

Player

Get a player by their FotMob id: name, current team, position, country, and headline season stats. Resolve the player id with `search` (or the squad list from `team`) first.

Fifa rankings

Get the FIFA/Coca-Cola Men's World Ranking of national teams: each nation's rank, points, previous rank, and movement, with the table's publish date. Call with no arguments for the full table (every ranked nation). Pass `team_id` (a national team's FotMob id, from `search`) to also highlight that nation's own ranking. FIFA ranks national teams only, not clubs. Use `limit` to return just the top N.