Chess.com Player Profile & Rating Stats Scraper (Free)

Bulk export Chess.com player data as clean JSON: profile (real name, GM/IM title, country, location, followers, league, streamer status, join date) plus full rating statistics for rapid, blitz, bullet, daily and Chess960 — current Elo, peak Elo with the date and game link, and win/loss/draw records with computed win rate.

Feed it a list of usernames and get a tidy table back. Perfect for chess analytics, club dashboards, tournament research or leaderboards. This actor is 100% free — you only pay your own Apify platform usage.

Input

Field	Type	Default	Description
usernames	array of strings	(required)	Chess.com usernames. Profile URLs and @handles are normalized automatically.
includeStats	boolean	true	Also fetch ratings and win/loss/draw records per time control.

Output

One dataset item per player, always with an explicit status field (found, not_found or error) — the actor never crashes on an unknown username.

{
  "status": "found",
  "query": "hikaru",
  "username": "hikaru",
  "playerId": 15448422,
  "name": "Hikaru Nakamura",
  "title": "GM",
  "countryCode": "US",
  "location": "Florida",
  "followers": 1401036,
  "accountStatus": "premium",
  "league": "Legend",
  "isStreamer": true,
  "twitchUrl": "https://twitch.tv/gmhikaru",
  "joined": "2014-01-06T20:00:58.000Z",
  "lastOnline": "2026-07-13T10:35:20.000Z",
  "profileUrl": "https://www.chess.com/member/Hikaru",
  "totalGames": 565,
  "peakFormat": "rapid",
  "peakRating": 2927,
  "fideRating": 2802,
  "tacticsHighest": 3350,
  "puzzleRushBest": 62,
  "formats": {
    "rapid": {
      "currentRating": 2839,
      "currentRatingDate": "2025-10-21T18:45:06.000Z",
      "bestRating": 2927,
      "bestRatingDate": "2022-02-26T18:48:34.000Z",
      "bestGameUrl": "https://www.chess.com/game/live/141332265952",
      "record": { "win": 201, "loss": 67, "draw": 209, "total": 477, "winRate": 42.1 }
    }
  },
  "error": null
}

Use cases

• Chess analytics & dashboards — track a roster of players' ratings over time by scheduling this actor.
• Club or team leaderboards — pull every member's peak rating and game count in one run.
• Tournament & opponent research — check titles, formats played and win rates before a match.
• Content & journalism — sourced, up-to-date numbers on top players for articles and videos.

Limitations & fair use

• Uses the official public Chess.com Published-Data API. Only public profile data is available — no private games or emails.
• The API is read-only and rate-limited; this actor applies a polite delay between requests and retries up to 3 times with backoff. Very large username lists will run proportionally longer.
• downloads-style live values (lastOnline, ratings) are point-in-time snapshots. Schedule the actor if you need a time series.
• Data belongs to Chess.com and its users; respect their terms of service when redistributing.

More actors by this developer

Browse the full collection of free data and enrichment actors: apify.com/fit_melon