Chess Ratings Aggregator

Aggregate chess player ratings from FIDE, Chess.com, Lichess, and 2700chess into one unified dataset. Compare ratings across sources side-by-side, track 12-month rating progression, detect prodigies and veterans, measure gap to the top. Built for chess journalists, content creators, researchers, and federations who need cross-platform chess data without manually hopping between sites.

---

What does Chess Ratings Aggregator do?

Chess Ratings Aggregator fetches chess player ratings from four sources and returns a consolidated dataset with one row per player. No single chess data service does this aggregation today.

• FIDE ratings - Classical, rapid, and blitz ratings from the official FIDE top lists (scraped from ratings.fide.com)
• Chess.com ratings - Bullet, blitz, rapid, and daily ratings from the public Chess.com API, plus FIDE rating from Chess.com's integrated profile
• Lichess ratings - Classical, rapid, blitz, and bullet ratings with daily rating history for the last 12 months
• 2700chess live ratings - Opt-in live classical ratings (browser-based, uses residential proxy)
• Peak ratings - All-time peak rating per time control where available
• Rating progression - Last 12 months of monthly (FIDE) and daily (Lichess) rating points
• Insights per player - Gap to #1, gap to next rank, rating trend, age/rating efficiency classification

---

What data does Chess Ratings Aggregator return?

One row per player with nested ratings:

Field	Description
name	Player name in FIDE format
fideId	FIDE ID (canonical identifier)
country	ISO3 country code
title	GM, IM, FM, WGM, etc.
age	Current age
ratings.fide	FIDE ratings and rank by time control, with peak
ratings.chessCom	Chess.com ratings with peak, plus FIDE rating shown on Chess.com profile
ratings.lichess	Lichess ratings per time control with games count
ratings.twoSevenHundred	2700chess live classical rating (opt-in)
ratingHistory	12-month monthly (FIDE) and daily (Lichess) rating points
insights.gapToTop	Rating points behind world #1
insights.gapToNext	Rating points to the next higher-ranked player
insights.ratingTrend12m	Rating change over last 12 months
insights.ageEfficiency	"prodigy" (age<20, rating>2700), "veteran" (age>=50, rating>=2600), or "peak-age"

---

How does Chess Ratings Aggregator work?

1. Fetches the FIDE top list for the selected time control (classical, rapid, or blitz)
2. Loads Chess.com and Lichess leaderboards in parallel for player matching
3. Matches FIDE players to their Chess.com and Lichess usernames using a curated seed mapping plus fuzzy name matching (Levenshtein + country boost)
4. Enriches each player with Chess.com stats, Lichess ratings, and rating history
5. Optionally scrapes 2700chess via browser when include2700chess is enabled
6. Computes per-player insights (rating gaps, trends, age efficiency)
7. Returns one row per player with everything merged

Player matching uses a hardcoded seed for the top ~20 players (confirmed Chess.com/Lichess usernames) and fuzzy name matching for the rest. Outside the top 20, Chess.com and Lichess data may be missing if the usernames cannot be matched reliably.

---

Why use Chess Ratings Aggregator instead of visiting each site?

Feature	Visit each site manually	Chess Ratings Aggregator
Sources covered	FIDE + Chess.com + Lichess + 2700chess (4 tabs)	All four in one output
Rating comparison	Manual copy-paste into spreadsheet	Side-by-side per player
Rating history	Not exposed on most sites	12 months monthly + daily
Peak rating	Only on FIDE profile	Included per source
Gap analysis	Not available	Gap to #1, gap to next rank
Age classification	Manual calculation	Prodigy, veteran, peak-age tags
Country filter	Only on FIDE	On every source
API access	Chess.com and Lichess only	Full Apify API on aggregated output

---

How to use Chess Ratings Aggregator?

1. Create an Apify account using your email
2. Open Chess Ratings Aggregator in Apify Store
3. Choose mode: Top players for a leaderboard, Single player lookup to find one specific player
4. Pick the time control (classical, rapid, blitz, or all)
5. Optionally filter by country or gender
6. Click Start - results appear in the output dataset

---

Input example

Top 20 classical players with Chess.com and Lichess enrichment

{
    "mode": "top",
    "topN": 20,
    "timeControl": "classical",
    "includeChessCom": true,
    "includeLichess": true,
    "includeRatingHistory": true
}

Single player lookup by name

{
    "mode": "player",
    "playerName": "Magnus Carlsen",
    "includeChessCom": true,
    "includeLichess": true,
    "includeRatingHistory": true
}

Top 50 women classical players from India

{
    "mode": "top",
    "topN": 50,
    "timeControl": "classical",
    "filterByGender": "women",
    "filterByCountry": ["IND"]
}

---

Output example

{
    "name": "Carlsen, Magnus",
    "fideId": "1503014",
    "country": "NOR",
    "title": "GM",
    "age": 36,
    "ratings": {
        "fide": {
            "classical": { "rating": 2840, "rank": 1, "peak": { "rating": 2882, "year": 2014 } }
        },
        "chessCom": {
            "username": "MagnusCarlsen",
            "fideFromChessCom": 2882,
            "bullet": { "rating": 3377, "peak": 3401 },
            "blitz": { "rating": 3213, "peak": 3280 },
            "rapid": { "rating": 2941, "peak": 2977 }
        },
        "lichess": {
            "username": "DrNykterstein",
            "title": "GM",
            "blitz": { "rating": 3153, "games": 5421 },
            "bullet": { "rating": 3197, "games": 8922 },
            "classical": { "rating": 2500, "games": 47 }
        }
    },
    "ratingHistory": {
        "fide_classical": [
            { "month": "2025-04", "rating": 2830 },
            { "month": "2026-04", "rating": 2840 }
        ]
    },
    "insights": {
        "gapToNext": 0,
        "gapToTop": 0,
        "ratingTrend12m": 10,
        "ageEfficiency": "peak-age"
    },
    "scrapedAt": "2026-04-12T15:00:00.000Z"
}

---

How much does Chess Ratings Aggregator cost?

Cost scales linearly with topN:

• FIDE scraping - downloads the official full FIDE rating list (standard, rapid, or blitz) and ranks/filter players locally, plus 1 request per profile when includeRatingHistory: true. No proxy needed.
• Chess.com API - free, 1 request per player for stats. No cost.
• Lichess API - free, 2 requests per player (user + rating history). No cost.
• 2700chess - opt-in only. Requires residential proxy. Adds approximately 0.30 USD per run.

A typical topN: 100 run takes 3-5 minutes and costs around 0.05-0.10 USD without 2700chess.

---

Are there other e-commerce and data tools in Apify Store?

• E-commerce Scraping Tool - Scrape product data, prices, and reviews from any e-commerce site
• Amazon Review Unmet Needs Extractor - Identify recurring product gaps from Amazon reviews using AI or keyword frequency
• Product Matching Vectorizer - Build vector indexes from product catalogs for similarity matching

---

Frequently asked questions

Which chess rating sources does Chess Ratings Aggregator support?

Chess Ratings Aggregator supports FIDE (ratings.fide.com), Chess.com (api.chess.com), Lichess (lichess.org/api), and optionally 2700chess.com (via browser due to Cloudflare). Freestyle Chess is not supported in v0.1 because there is no public ranking page.

Why do some players show FIDE data only?

Matching FIDE players to their Chess.com and Lichess usernames is challenging because there is no universal mapping. Chess Ratings Aggregator uses a seed mapping for the top ~20 confirmed players plus fuzzy name matching for the rest. Outside the top 20, Chess.com and Lichess data may be missing. Contact us to add more players to the seed mapping.

How is "age efficiency" calculated?

The ageEfficiency field is a simple classification based on age and current rating: "prodigy" for players under 20 rated above 2700, "veteran" for players 50 or older rated above 2600, and "peak-age" for players between 25 and 40.

Can Chess Ratings Aggregator lookup a single player by name?

Yes. Set mode: "player" and provide playerName (e.g., "Magnus Carlsen" or "Carlsen, Magnus") or fideId. The actor fetches full data for that one player across all sources.

How far back does rating history go?

The last 12 months. FIDE rating history is monthly granularity (12 data points per player). Lichess rating history is per-day (can be hundreds of points per player for active players).

Can I use Chess Ratings Aggregator through an MCP Server?

Yes. Connect via the Apify MCP server for use with Claude Desktop, Claude Code, or any MCP-compatible AI assistant.

Can I use Chess Ratings Aggregator with the Apify API?

Yes. The Apify API gives you programmatic access to run Chess Ratings Aggregator, schedule monthly updates, and pipe the output to your database or dashboard.

Is scraping FIDE and 2700chess legal?

Chess Ratings Aggregator only reads publicly available ratings pages. No authentication bypass, no private data. Chess.com and Lichess are accessed via their official free public APIs. Read more about the legality of web scraping.

---

Your feedback

Found a bug, need a player added to the seed mapping, or want a new source supported? Create an issue on the Actor page.