FIFA APIfifa.com ↗
Access FIFA world rankings, tournament fixtures, match timelines, player stats, and news from fifa.com via 17 structured endpoints.
What is the FIFA API?
The FIFA.com API covers 17 endpoints returning men's and women's world rankings, tournament fixtures and standings, detailed match data, player profiles, and news articles from fifa.com. The get_match_timeline endpoint, for example, returns a full sequence of in-match events — goals, cards, substitutions — keyed by match minute and player ID, making it straightforward to reconstruct how any FIFA tournament match unfolded.
curl -X GET 'https://api.parse.bot/scraper/29ef51e4-86d0-4580-a598-4c86dfa6e5ff/get_mens_world_ranking?limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fifa-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FIFA Data API — rankings, competitions, matches, players, articles."""
from parse_apis.FIFA_Data_API import FIFA, CompetitionId, SeasonId, NotFoundError
client = FIFA()
# Men's world ranking — top teams by FIFA points.
for team in client.ranked_teams.mens(limit=5):
print(team.rank, team.country_code, team.total_points, team.confederation_name)
# List competitions, then drill into one via constructible.
comp = client.competitions.list(limit=1).first()
if comp:
print(comp.id, comp.name)
# Construct a competition and list its seasons.
world_cup = client.competition(id=CompetitionId._17)
season = world_cup.seasons(limit=1).first()
if season:
for standing in world_cup.standings(stage_id="289273", season_id=SeasonId._285023, limit=3):
print(standing.position, standing.team_id, standing.points, standing.goal_difference)
# Fetch a player profile with error handling.
try:
player = client.players.get(player_id="406304")
print(player.name, player.country_code, player.international_caps, player.goals)
except NotFoundError as exc:
print(f"Player not found: {exc}")
# Browse recent articles.
article = client.articles.list(limit=1).first()
if article:
print(article.title, article.published_date)
# Search for content.
results = client.search_responses.search(query="World Cup")
print(results.took, len(results.hits))
print("exercised: ranked_teams.mens / competitions.list / competition.seasons / competition.standings / players.get / articles.list / search_responses.search")
Retrieve the full FIFA Men's World Ranking. Returns teams ranked by FIFA points in descending order. Each team includes rank, points, movement since last ranking, confederation, and country code.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of teams to return. |
{
"type": "object",
"fields": {
"Results": "array of ranked team objects with Rank, TeamName, TotalPoints, RankingMovement, ConfederationName, IdTeam, IdCountry"
},
"sample": {
"data": {
"Results": [
{
"Rank": 1,
"Gender": 1,
"IdTeam": "43946",
"Matches": 50,
"PubDate": "2026-04-01T13:00:00+00:00",
"PrevRank": 3,
"TeamName": [
{
"Locale": "en-GB",
"Description": "France"
}
],
"IdCountry": "FRA",
"TotalPoints": 1877,
"IdConfederation": "27275",
"RankingMovement": 2,
"ConfederationName": "UEFA",
"DecimalTotalPoints": 1877.32
}
],
"ContinuationHash": null,
"ContinuationToken": null
},
"status": "success"
}
}About the FIFA API
Rankings and Tournaments
The get_mens_world_ranking and get_womens_world_ranking endpoints each return an ordered array of team objects including Rank, TeamName, and TotalPoints, with an optional limit parameter to cap the result set. Tournament discovery starts with get_tournaments_list, which returns a flat list of competitionId and name pairs. From there, get_tournament_seasons accepts a competition_id and returns all editions of that tournament with IdSeason, StartDate, and EndDate — the IDs returned here feed into the fixture and standings endpoints.
Fixtures, Standings, and Match Detail
get_tournament_scores_fixtures takes a season_id and returns every match in that season, including Home, Away, Date, Stadium, and MatchStatus. Group-stage standings are available via get_tournament_standings, which requires stage_id, season_id, and competition_id and returns position, points, wins, draws, losses, goals for, and goals against per team. For richer per-match data, get_match_detail returns lineups, officials, ball possession, and full score details. get_match_timeline goes further, providing an event-level breakdown — each object in the Event array carries Type, TypeLocalized, MatchMinute, and IdPlayer.
Players and News
Player data is split across two endpoints. get_player_profile returns biographical fields — Name, Height, Weight, BirthDate — for a given player_id. get_player_stats takes a season_id for a completed or in-progress tournament and returns match-level statistics keyed by player ID. Note that this endpoint only produces results for seasons with available match data; historical seasons with no indexed data return empty.
News coverage comes through get_news_list, which returns article summaries with title, publishedDate, articlePageUrl, and thumbnail image. Individual articles are fetched with get_news_article using the entryId from the list response; the full body is returned as a structured Contentful rich-text document alongside heroImage and articlePublishedDate. The search endpoint accepts a free-text query and returns matched articles, videos, and documents with a total hit count and query duration in milliseconds.
The FIFA API is a managed, monitored endpoint for fifa.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fifa.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fifa.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a live FIFA World Rankings tracker showing Rank and TotalPoints for all men's or women's national teams.
- Reconstruct match narratives by replaying goal and card events from get_match_timeline in chronological order.
- Aggregate group-stage standings across multiple World Cup editions using get_tournament_standings with different season_id values.
- Power a tournament calendar app with upcoming and past fixtures from get_tournament_scores_fixtures filtered by season.
- Display player cards with height, weight, birth date, and season stats by combining get_player_profile with get_player_stats.
- Surface FIFA+ news headlines and full article bodies in a football news aggregator using get_news_list and get_news_article.
- Implement a football content search feature using the search endpoint to match queries against FIFA articles and videos.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.