Chess.com Published Data API

Base URL

https://api.chess.com/pub

Authentication

No API key required. Chess.com asks for a descriptive User-Agent with contact details.

Rate limit

No published hard limit, but parallel requests to the same endpoint are throttled — serialise them.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://api.chess.com/pub/player/hikaru'

const res = await fetch("https://api.chess.com/pub/player/hikaru");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.chess.com/pub/player/hikaru", timeout=20)
res.raise_for_status()
print(res.json())

{
  "avatar": "https://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png",
  "player_id": 15448422,
  "@id": "https://api.chess.com/pub/player/hikaru",
  "url": "https://www.chess.com/member/Hikaru",
  "name": "Hikaru Nakamura",
  "username": "hikaru",
  "title": "GM",
  "followers": 1406493,
  "country": "https://api.chess.com/pub/country/US",
  "location": "Florida",
  "last_online": 1787160848,
  "joined": 1389043258,
  "status": "premium",
  "is_streamer": true,
  "twitch_url": "https://twitch.tv/gmhikaru",
  "verified": false,
  "league": "Legend",
  "streaming_platforms": [
    {
      "type": "twitch",
      "channel_url": "https://twitch.tv/gmhikaru"
    }
  ]
}

player_id / usernameinteger|string

Player identifiers.

titlestring

Chess title such as GM or IM, when held.

followersinteger

Follower count.

countrystring

URL of the country resource — follow it for the name.

statusstring

Account status such as premium or basic.

last_online / joinedinteger

Unix timestamps.

• Track a player's rating progression over time
• Download and analyse game archives
• Build a club or tournament leaderboard
• Embed the daily puzzle in a chess site

If Chess.com Published Data does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.