APIHub

Loading API details…

Back to Explore

Chess.com

The Chess.com public REST API provides read‑only access to player‑centric information such as profile details, title listings, rating statistics, and online‑status checks, as well as collections of a player’s daily and live games—including archives by month, games where it’s the player’s turn, and games filtered by specific time controls. All endpoints are simple GET requests and optionally accept a JSONP callback parameter.

Games & Comics

none

HTTPS

CORS: Unknown

REST only

Description enriched …

Visit official documentation

Admin actions

Latency p95

964 ms

last successful checks

Uptime 30d

100.0%

monitored sample

Playground

Verified

live · allowlisted

Endpoints & operations

REST · JSON · 9

GET

/pub/player/{username}

Get additional details about a player.

username path · required — The Chess.com username of the player (case‑preserving).callback query — Optional JSONP callback function name.

GET

/pub/titled/{title}

List of usernames that hold a specific chess title.

title path · required — Title abbreviation (e.g., GM, WGM, IM, etc.).callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/stats

Retrieve ratings, win/loss, and other statistics for a player.

username path · required — The Chess.com username of the player.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/is-online

Check whether a user has been online in the last five minutes.

username path · required — The Chess.com username of the player.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/games

Array of Daily Chess games that a player is currently playing.

username path · required — The Chess.com username of the player.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/games/to-move

Array of Daily Chess games where it is the player's turn to act.

username path · required — The Chess.com username of the player.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/games/archives

List of monthly archives available for the player.

username path · required — The Chess.com username of the player.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/games/{year}/{month}

Complete monthly archive of Live and Daily Chess games finished by the player.

username path · required — The Chess.com username of the player.year path · required — Four‑digit year (YYYY) of the archive.month path · required — Two‑digit month (MM) of the archive.callback query — Optional JSONP callback function name.

GET

/pub/player/{username}/games/live/{baseTime}/{increment}

Live Chess games finished by the player for a specific time control.

username path · required — The Chess.com username of the player.baseTime path · required — Base time control in seconds.increment path — Increment in seconds (optional; omit if none).callback query — Optional JSONP callback function name.

⚠ Requires none authentication — check the API’s own docs for the exact header/param to use.

curl -X GET \
  "https://www.chess.com/news/view/published-data-api/pub/player/{username}?callback=YOUR_VALUE"

www.chess.com · HTTPS only · none auth