FIDE APIratings.fide.com ↗
Access FIDE chess player profiles, top 100 rankings, rating history, and game statistics across standard, rapid, and blitz time controls.
What is the FIDE API?
The FIDE Ratings API exposes 4 endpoints covering the official chess ratings database at ratings.fide.com. Use get_top_players to retrieve the top 100 players for any ranking category, search_players to find players by name or FIDE ID, and get_player_profile to pull a full profile including ratings across all three time controls, game statistics broken down by color and time control, ranking history, and a list of recent opponents.
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 Lookup
The search_players endpoint accepts a query parameter (partial name or numeric FIDE ID) and returns matching players with fide_id, name, title, federation, standard_rating, rapid_rating, blitz_rating, and birth_year. It supports partial name matches, so querying "Carlsen" will return Magnus Carlsen alongside any other registered players with that name fragment.
Top Rankings
The get_top_players endpoint returns the current top 100 list for a given category. Each entry includes rank, name, fide_id, federation, rating, and birth_year. The category parameter controls which list is returned — options cover open, women, junior, and similar ranking groups maintained by FIDE. Results are ordered by rank.
Full Player Profiles
The get_player_profile endpoint takes a numeric FIDE ID string and returns a detailed record: std_rating, fide_title, federation, birth_year, photo_url, a statistics array breaking down wins, draws, and losses by color and time control, a ranks object mapping each ranking category to the year it was achieved, and an opponents array with id_number, name, and country for recent opponents.
Non-Playing Titles
The get_player_titles endpoint retrieves arbiter and trainer designations associated with a FIDE ID. The titles array returns license level, license status, and title strings from the Arbiter/Trainer section of the player's profile — useful for applications that need to distinguish over-the-board players from officiating or coaching staff.
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 live FIDE top-100 leaderboard displaying federation, rating, and birth year for any ranking category
- Autocomplete a player search field using partial name queries with standard, rapid, and blitz ratings displayed per result
- Display a player's career peak rankings by year using the
ranksfield fromget_player_profile - Analyze win/draw/loss ratios by color and time control from the
statisticsarray for coaching or scouting tools - Identify certified FIDE arbiters and trainers for a tournament management platform using
get_player_titles - Compare rating trajectories between two players by fetching their profiles and plotting
std_ratingalongside ranking history - Populate an opponent history view with federation and name data from the
opponentsarray in a player profile
| 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 a rating number?+
statistics (wins, draws, losses segmented by piece color and time control), a ranks object mapping each ranking category to the year the player achieved it, an opponents array with FIDE IDs, names, and countries, a photo_url, fide_title, federation, birth_year, and the player's standard rating. Rapid and blitz ratings at the profile level are not currently included in this endpoint's response fields — they are available via search_players instead.Does the API cover historical rating changes month by month?+
ranks history object tied to peak ranking years, but do not expose a month-by-month rating history series. You can fork this API on Parse and revise it to add an endpoint targeting the historical rating chart data for a given FIDE ID.What ranking categories are available in `get_top_players`?+
category parameter is optional and accepts strings corresponding to FIDE's published ranking lists, such as open, women, juniors, girls, rapid open, rapid women, blitz open, and blitz women. If omitted, a default list is returned. The endpoint always returns up to 100 players per category.