Chess FIDE Ratings & Players

Pull official chess ratings from FIDE (the International Chess Federation) without opening a spreadsheet. The Actor reads the public monthly rating lists and the public player profile pages, and gives you clean, filterable rows.

What it does

• Streams the current monthly FIDE rating list (standard, rapid or blitz) and keeps only the players that match your filters. The list file is never held in memory in full, so runs stay small.
• Looks up individual players by FIDE ID to get their three current ratings, world and national rank, titles with the year earned, and optionally the month-by-month rating history.
• Offers a shortcut for "top N players" by country.

All data comes from public FIDE pages. The Actor runs one request stream at a time, waits between profile requests and retries politely on errors.

Modes

1. rating-list

Filter the monthly list by federation, title, rating range, sex and activity.

{
  "mode": "rating-list",
  "ratingType": "standard",
  "federations": ["ARG", "ESP"],
  "titles": ["GM", "IM"],
  "minRating": 2400,
  "activeOnly": true,
  "sortBy": "rating_desc",
  "maxItems": 100
}

sortBy can be rating_desc (default), rating_asc or list_order. Sorted output needs a pass over the whole list (about 570,000 players, one to two minutes); only the best rows are kept in memory. list_order streams in FIDE's alphabetical order and stops the download the moment maxItems rows were found.

2. player-profile

{
  "mode": "player-profile",
  "fideIds": ["1503014", "5000017"],
  "includeRatingHistory": true
}

You can also pass profileUrls such as https://ratings.fide.com/profile/1503014.

3. top-players

The best players by rating for a federation (or the whole world), active players only unless you set activeOnly to false.

{
  "mode": "top-players",
  "ratingType": "rapid",
  "federations": ["NOR", "IND"],
  "maxItems": 10
}

Output

Rating-list and top-players rows:

Field	Meaning
fideId	FIDE ID
name	Name as published by FIDE
federation	Three-letter federation code
sex	M or F
title / womenTitle	Open title (GM, IM, ...) and women's title (WGM, ...)
otherTitles	Other titles carried on the list (o_title and foa_title fields)
ratingType	standard, rapid or blitz
rating, games, kFactor	Rating, games rated in the period, K factor
birthYear	Year of birth
flag / inactive	Raw FIDE flag and whether the player is marked inactive
ratingListDate	Month of the list, e.g. 2026-10
profileUrl	Link to the FIDE profile

Player-profile rows:

Field	Meaning
fideId, name, federation, federationCode	Identity and country
birthYear, sex, title	Basic details
titles	Array of titles with the year they were earned
standardRating, rapidRating, blitzRating	Current ratings
worldRankActive / worldRankAll	World rank among active / all players
nationalRankActive / nationalRankAll	Rank inside the federation
continentRank, continentRankActive	Continent name and active rank
ratingHistory	With includeRatingHistory: array of {period, standard, standardGames, rapid, rapidGames, blitz, blitzGames}
profileUrl	Link to the FIDE profile

Notes

• Players without a rating in the chosen category are skipped in list modes.
• The list reflects the month FIDE published last; ratingListDate tells you which.
• Rating history covers the months shown on the profile page (typically several years).
• Tournament-by-tournament calculations are loaded dynamically by FIDE and are not included.
• The Actor stops when maxItems is reached or when your maximum charge for the run is hit.
• Proxy is optional and normally unnecessary.

Pricing

This Actor is pay-per-event, with three charges:

• Profile (player-profile mode): one charge per profile returned. Profile pages are fetched through a residential proxy because the source does not accept datacenter IPs.
• List download (rating-list and top-players modes): one charge per run for downloading the monthly FIDE list (a large file, also fetched through the proxy when the direct connection fails).
• Result row (list modes): a small charge per player row returned.

Set a maximum charge per run in the run options if you want a hard spending cap.