Pricing
from $3.00 / 1,000 results
Chess.com Scraper
Scrape Chess.com - leaderboards, player profiles, stats, and game archives. Fully public API, zero credentials required.
Pricing
from $3.00 / 1,000 results
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
23 days ago
Last modified
Categories
Share
Scrape Chess.com — the world's largest chess platform with 100M+ members. Extract leaderboards, player profiles, ratings, and game archives via the fully public Chess.com API. No API key or credentials required.
What you can scrape
- Global leaderboards — Top players across Rapid, Blitz, Bullet, Daily, Chess960, Tactics, and more
- Player profiles — Username, title (GM/IM/FM), country, bio, followers, streaming status
- Player stats — Current and best ratings across all game types
- Game archives — Full game history with PGN notation, ratings, results
Output fields
Leaderboard entries
| Field | Description |
|---|---|
username | Chess.com username |
title | Chess title (GM, IM, FM, NM, etc.) |
country | ISO country code |
score | Leaderboard rating/score |
rank | Position on leaderboard |
gameType | Game type identifier |
gameTypeLabel | Human-readable game type |
sourceUrl | Link to player profile |
Player profiles
| Field | Description |
|---|---|
name | Full display name |
bio | Player biography |
location | Location string |
followers | Follower count |
isStreamer | Whether player streams |
joinedAt | Account creation date (ISO 8601) |
lastOnlineAt | Last seen date (ISO 8601) |
Game records
| Field | Description |
|---|---|
whiteUsername | White player |
blackUsername | Black player |
whiteRating | White player rating |
blackRating | Black player rating |
winner | white, black, or draw |
timeClass | rapid, blitz, bullet, daily |
rated | Whether game was rated |
endedAt | Game end timestamp |
pgn | Full PGN notation |
Input options
| Field | Type | Description |
|---|---|---|
mode | select | leaderboard, player, playerStats, playerGames |
gameType | select | Leaderboard type (Rapid, Blitz, Bullet, etc.) |
username | string | Chess.com username for player modes |
year | integer | Year for game archive |
month | integer | Month 1-12 for game archive |
maxItems | integer | Max records (1–1000) |
Example use cases
- Player ranking — Get top 50 rapid chess players worldwide
- Profile lookup — Scrape rating history for a specific player
- Game analysis — Download PGN archives for analysis
- Market research — Identify top streamers and their follower counts
FAQ
Does this require an API key? No. Chess.com's API is completely public with no authentication.
How many leaderboard entries are returned? Chess.com returns up to 50 entries per leaderboard type.
Can I get game PGN data?
Yes. The playerGames mode returns full PGN notation for each game.
What game types are available? Rapid, Blitz, Bullet, Daily, Chess960 Daily, Bughouse, Blitz960, Three-Check, Crazyhouse, King of the Hill, Tactics, Puzzle Rush, and Battle.
