Chess.com Published-Data API
65
AI ReadinessAI-Aware (B)65/100
Agent-ready OpenAPI document · curated by JenticMediaContent Deliverynone28 EndpointsREST
Know of an official OpenAPI document?
Install Jentic One Beta
Connect the Chess.com Published-Data API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Chess.com Published-Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchess.com%2Fchess" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchess.com%2Fchess" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Chess.com Published-Data API.
Retrieve a player's profile, ratings, and win and loss statistics
Pull monthly game archives in PGN and JSON for any public username
Check whether a player is online and which games await their move
Browse clubs, their members, and team match results
Read country pages, titled-player lists, and global leaderboards
Fetch the daily puzzle or a random puzzle for study tools
Use Cases
Patterns agents use Chess.com Published-Data API for, with concrete tasks.
★ Game analysis and coaching tools
Chess coaching and analysis apps need a player's recent games to review mistakes and track progress. The Chess.com API returns monthly archives in PGN and JSON for any public account, so a tool can pull a student's games and feed them to an engine or lesson plan.
Fetch last month's rated games for a given username and return them as PGN for engine analysis
Player scouting and rating dashboards
Scouting and leaderboard dashboards track ratings and activity across many accounts. The API exposes per-player statistics, online status, and the global leaderboards, letting a dashboard refresh standings and compare players without scraping.
Read a player's blitz, rapid, and bullet ratings and compare them against the current leaderboard
Agent-driven chess study assistant
An AI study assistant can answer questions about a player and set up practice. Through Jentic, an agent resolves a request like reviewing a user's week into the right read operations, pulling profile, recent games, and the daily puzzle in sequence.
Given a username, gather the player's profile, this month's games, and the daily puzzle for a study session
Key Endpoints
28 endpoints — jentic publishes the only available openapi specification for chess.
METHOD
PATH
DESCRIPTION
GET
/player/{username}
Get a player's profile
GET
/player/{username}/stats
Get a player's rating statistics
GET
/player/{username}/games
Get a player's current daily games
GET
/player/{username}/games/{year}/{month}
Get a monthly game archive
GET
/leaderboards
Get the global leaderboards
GET
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Chess.com needs no key, so the only real work is handling its per-endpoint URL shapes and JSON responses. With Jentic One you install once, import the read operations from the API Directory, and point an agent at them.
Permission scoping
Every operation is read-only, and because resources like username and club id are path parameters you can scope an agent to specific reads such as player statistics or leaderboards.
Credential isolation
There is no credential to handle: the service is public, so nothing is stored and no secret ever reaches the agent's prompt or logs.
Intent-based discovery
Agents find the right Chess.com read through Jentic's intent search, matching a request like getting a chess player's rating to the exact operation.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Chess.com Published-Data API through Jentic.
Do I need an API key to use the Chess.com API?
No. The published-data service is read-only and public, so there is no key to request and nothing to store. Jentic One sends each request straight through to Chess.com.
Can I limit what my agent is allowed to do with the Chess.com API?
Yes. Every operation is a read, and you choose which read operations to import into your Jentic One instance, so an agent can be allowed to fetch player statistics while being blocked from everything else.
What data does the Chess.com API return?
Public player profiles and statistics, monthly game archives, clubs and team matches, country pages, tournaments, daily puzzles, streamers, and leaderboards, all as JSON.
Is Chess.com game history available in PGN?
Yes. Monthly archives return each game in both PGN and JSON, so analysis tools can replay moves directly.
Why is there no official OpenAPI spec for Chess.com?
Chess.com documents its published-data service in prose rather than a machine-readable spec. Jentic generated this OpenAPI description from that documentation and keeps it validated so agents can call it reliably.
GET STARTED