fifa.com APIfifa.com ↗
Access FIFA world rankings, tournament fixtures, match timelines, player stats, and news from fifa.com via 17 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/29ef51e4-86d0-4580-a598-4c86dfa6e5ff/get_mens_world_ranking?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full FIFA Men's World Ranking. Returns teams ranked by FIFA points in descending order.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of teams to return. |
{
"type": "object",
"fields": {
"Results": "array of ranked team objects with Rank, TeamName, TotalPoints, and other ranking details"
},
"sample": {
"data": {
"Results": [
{
"Rank": 1,
"IdTeam": "43922",
"TeamName": [
{
"Locale": "en-GB",
"Description": "Argentina"
}
],
"RankingDate": "2025-04-03T00:00:00Z",
"TotalPoints": 1867.25,
"PreviousRank": 1
}
]
},
"status": "success"
}
}About the fifa.com 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.
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.
- 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 | 250 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.