FIFA API: Get world ranking
Gets the latest official FIFA men's or women's national-team ranking, with points and movement since the previous ranking. Unranked teams are excluded.
Unofficial. Not affiliated with or endorsed by FIFA.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country National team to find by country name or three-letter FIFA code, for example Brazil.
Not set
- Ranking optional
ranking Ranking to view, for example men.
men (default)
One of
men,women.- Max Results optional
max_results Maximum number of ranked teams to return, for example 50.
50 (default)
Whole number from 1 to 211.
Input as JSON
{}Output
{ "teams": [ { "rank": 1, "country": "Spain", "page_link": "https://inside.fifa.com/associations/ESP" , "places_moved": 1, "total_points": 1995.88, "confederation": "UEFA", "previous_rank": 2 }, { "rank": 2, "country": "Argentina", "page_link": "https://inside.fifa.com/associations/ARG" , "places_moved": -1, "total_points": 1970.37, "confederation": "CONMEBOL", "previous_rank": 1 }, { "rank": 3, "country": "France", "page_link": "https://inside.fifa.com/associations/FRA" , "places_moved": 0, "total_points": 1948.97, "confederation": "UEFA", "previous_rank": 3 } ], "ranking_type": "men", "ranking_release_date": "2026-07-20"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fifa.com/get_world_ranking","input":{}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "fifa.com/get_world_ranking" , "input": {}})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "fifa.com/get_world_ranking" , "input": {} }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run fifa.com/get_world_ranking# with {}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "country": { "type": "string", "description": "National team to find by country name or three-letter FIFA code, for example Brazil." }, "ranking": { "enum": [ "men", "women" ], "type": "string", "default": "men", "description": "Ranking to view, for example men." }, "max_results": { "type": "integer", "default": 50, "maximum": 211, "minimum": 1, "description": "Maximum number of ranked teams to return, for example 50." } }}Output schema
{ "type": "object", "required": [ "ranking_type", "ranking_release_date", "teams" ], "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "country": { "type": "string" }, "page_link": { "type": "string" }, "places_moved": { "type": [ "integer", "null" ] }, "total_points": { "type": "number" }, "confederation": { "type": [ "string", "null" ] }, "previous_rank": { "type": [ "integer", "null" ] } } } }, "ranking_type": { "type": "string" }, "ranking_release_date": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
fifa.com/get_world_ranking- Returns
- release date, rank, country, confederation, points, previous rank, movement
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method fifa.com/get_world_ranking with the inputs above.
Ask your agent
- What is Brazil's current position in the men's FIFA world ranking and how many points do they have?
- Show me the top 20 women's national teams in the latest FIFA rankings with their movement since last release.
- Has Argentina moved up or down in the latest official men's world rankings compared to the previous update?
- Which confederation does Nigeria belong to and what rank did they hold in the previous women's FIFA ranking?
- Give me the full list of the top 50 men's national teams from the newest FIFA ranking release, including points and previous rank.
See more
All FIFA methodsGets FIFA tournament matches in kick-off order, with scores, stages, teams and venues. The tournament name must include a year.
fifa.com/get_tournament_matchesGets the ATP men's singles world rankings as of the latest published ranking date. Finds one ranked player by name, or returns up to 500 ranked players in rank order.
atptour.com/get_rankingsRanks countries by a World Economic Outlook indicator for a chosen year, excluding regional and group totals and countries without a value.
imf.org/list_country_rankingsRanks Premier League players for a season by goals, assists or goalkeeper clean sheets, with each player's club and nationality.
premierleague.com/list_top_scorersRanks countries by a World Development Indicators statistic for a given year, or for the latest year with broad country coverage. Regional aggregates and countries without data for that year are left out.
worldbank.org/compare_countriesLists the QS World University Rankings, or a QS subject ranking, for an edition and optionally one country, with each university's displayed rank, location, overall score and the indicator scores published for that table.
topuniversities.com/list_university_rankingsLists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
similarweb.com/list_top_websitesGets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
premierleague.com/get_fixtures_and_results