Chess.com API

⭐ Beginner's Pick Games & Comics / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

The Chess.com Published Data API gives you read-only access to public player profiles, game archives, leaderboards, and puzzle data from one of the world's largest chess platforms. No authentication is required — all data is publicly available and returned as JSON. It's a perfect beginner project for building chess stat trackers or analyzing game history.

💡

Beginner Tip

Monthly game archives can be very large; use the archive list endpoint first to get available months, then fetch only the specific month you need.

Available Data

Use case: Integrate chess.com read-only rest api data into web and mobile applications
Chess.com data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON Response
{
  "id": 1,
  "name": "Chess.com",
  "data": "Chess.com read-only REST API",
  "source": "Chess.com"
}

Field Reference

chess_rapid.last.rating Player's most recent rapid game rating.
chess_bullet.best.rating Player's all-time best bullet game rating.
fide Player's official FIDE rating if verified (0 if not linked).
tactics.highest.rating Highest puzzle tactics rating the player has achieved.
puzzle_rush.best.score Best score in the timed Puzzle Rush mode.

Implementation Example

const url = "https://www.chess.com/news/view/published-data-api";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found for player The username is case-sensitive and must be the exact Chess.com username.
Double-check the player's username on Chess.com; usernames are lowercase on the platform.
Slow response for game archive Monthly archives for active players can contain thousands of games.
Request only the specific month you need (e.g. /games/2024/01) rather than fetching all archives at once.
CORS error in browser The Chess.com API does not set permissive CORS headers for all endpoints.
Make requests from a server-side environment (Node.js, Python) rather than directly from a browser.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 762ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Games & Comics
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →