FIDE APIratings.fide.com ↗
Access FIDE chess ratings, top player rankings, full player profiles, game statistics, and tournament reports via a structured REST API.
What is the FIDE API?
The FIDE Ratings API exposes 5 endpoints covering the official FIDE chess ratings database, from top-100 ranking lists to individual player profiles with win/draw/loss breakdowns. The get_player_profile endpoint returns standard, rapid, and blitz ratings alongside opponent history and rank records. The get_tournament_source_report endpoint delivers full participant and game-by-game data for any FIDE-rated event by its numeric event code.
curl -X GET 'https://api.parse.bot/scraper/9565d770-db40-4e26-8563-4394e5d962cf/get_top_players?category=open' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the top 100 players list for a given category. Returns rank, name, FIDE ID, federation, rating, and birth year for each player. The category determines which ranking list is returned (e.g. open, women, juniors). Results are ordered by rank descending.
| Param | Type | Description |
|---|---|---|
| category | string | Ranking category. |
{
"type": "object",
"fields": {
"players": "array of player objects with rank, name, fide_id, federation, rating, and birth_year",
"category": "string indicating the requested ranking category"
},
"sample": {
"data": {
"players": [
{
"name": "Carlsen, Magnus",
"rank": 1,
"rating": 2841,
"fide_id": "1503014",
"birth_year": 1990,
"federation": "NOR"
},
{
"name": "Caruana, Fabiano",
"rank": 2,
"rating": 2792,
"fide_id": "2020009",
"birth_year": 1992,
"federation": "USA"
}
],
"category": "open"
},
"status": "success"
}
}About the FIDE API
Player Search and Rankings
The search_players endpoint accepts a query parameter (player name or FIDE ID, partial matches supported) and returns an array of matching players with fide_id, name, title, federation, standard_rating, rapid_rating, blitz_rating, and birth_year. The get_top_players endpoint takes an optional category parameter — such as open, women, or juniors — and returns the ranked top-100 list with each player's rank, name, fide_id, federation, rating, and birth_year.
Player Profiles and Titles
get_player_profile returns a detailed record for a single player identified by their numeric fide_id. Response fields include std_rating, fide_title, federation, birth_year, photo_url, a ranks object mapping rank category to year achieved, an opponents array with opponent name and country, and a statistics array broken down by color (white/black) and time control (standard, rapid, blitz) covering wins, draws, and losses. get_player_titles targets the same fide_id parameter but focuses on non-playing designations — arbiter and trainer licenses — returning each title string with license level and status.
Tournament Source Reports
get_tournament_source_report fetches the original submitted report for one FIDE-rated event using the numeric event_code visible in the tournament report header. The response includes tournament metadata (tournament_name, federation, city, start_date) alongside a players array where each participant record carries their fide_id, name, federation, title, rating, and a games array. Each game object includes round, date, color, opponent_name, opponent_federation, giving full round-by-round coverage of the event.
Coverage Notes
All five endpoints address data published on the official FIDE ratings site at ratings.fide.com. Rating values reflect the data as published; historical monthly rating snapshots and per-period rating change deltas are not exposed as separate endpoints in the current API.
The FIDE API is a managed, monitored endpoint for ratings.fide.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ratings.fide.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 ratings.fide.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 chess tournament bracket tool that pulls live FIDE rankings via
get_top_playersfor seeding - Display a player's complete competitive profile — ratings, titles, and game stats — using
get_player_profile - Resolve a player's FIDE ID from a partial name search to feed into downstream profile or tournament lookups
- Analyze win/draw/loss ratios by color and time control for any FIDE-registered player
- Retrieve full participant lists and game-by-game results for any FIDE-rated tournament via
get_tournament_source_report - Verify whether a chess coach or arbiter holds a valid FIDE trainer or arbiter license using
get_player_titles - Cross-reference opponent history from
get_player_profileto map a player's competitive network
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FIDE provide an official developer API for ratings.fide.com?+
What does `get_player_profile` return beyond just a rating number?+
std_rating and fide_title, the response includes a statistics array with win, draw, and loss counts broken down by both color (white and black) and time control (standard, rapid, blitz). It also returns a ranks object recording which category ranking the player has achieved and in which year, an opponents array, and a photo_url.Can I retrieve a player's rating history month by month?+
Does `get_tournament_source_report` return results for all FIDE-rated events, including online tournaments?+
Does the search endpoint support filtering by federation or title?+
search_players endpoint accepts only a query string (name or FIDE ID) and returns all matches with their federation and title fields included in each result. Server-side filtering by federation code or title (e.g. GM, IM) is not currently supported as a separate parameter. You can fork this API on Parse and revise it to add those filter parameters.