Chess.com data API
A player's public ratings and game record. Through FoxAPIs you send one request with one key and get fields back, the same shape as the other platforms.
fact The field tables are from real responses captured on 19 November 2026. The official API limits are quoted from Chess.com Published-Data API's own page, read 19 November 2026. Prices are credits per call from our catalog.
Endpoints
| Endpoint | Credits a call | Credits per 1,000 calls |
|---|---|---|
POST /v1/gaming/chess/player | 1 | 1,000 |
POST /v1/gaming/chess/player
Price. 1 credit a call, so 1,000 credits per 1,000 calls: about $9.80 per 1,000 calls on the Builder plan. fact: catalog credits Calculated by us: plan price divided by its credits.Formula
Fields filled in a real response (2026-11-19)
| Field | Type | Value in that response |
|---|---|---|
platform | string | chess.com |
username | string | hikaru |
title | string | GM |
name | string | Hikaru Nakamura |
country | string | US |
location | string | Florida |
joined_date | string | 2014-01-06 |
last_online | string | 2026-11-18 |
is_streamer | boolean | true |
verified | boolean | false |
league | string | Legend |
followers | number | 1435111 |
bullet | object | {"current_rating":3402,"best_rating":3570,"best_game_url":"https://www.chess.com/game/live/5710095242","win... |
blitz | object | {"current_rating":3453,"best_rating":3503,"best_game_url":"https://www.chess.com/game/live/184580310677","w... |
rapid | object | {"current_rating":2838,"best_rating":2927,"best_game_url":"https://www.chess.com/game/live/141332265952","w... |
daily | object | {"current_rating":2239,"best_rating":2464,"best_game_url":"https://www.chess.com/game/daily/84604826","wins... |
chess960_daily | object | {"current_rating":1231,"best_rating":1489,"best_game_url":"https://www.chess.com/game/daily/87191830","wins... |
tactics_rating | number | 2730 |
puzzle_rush_best | number | 123 |
profile_url | string | https://www.chess.com/member/Hikaru |
avatar | string | https://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png |
time_controls_glossary | object | {"bullet":"1-2 minutes per game","blitz":"3-5 minutes per game","rapid":"10-25 minutes per game","daily":"1... |
errors | list | [] |
credits_used | number | 1 |
0 other fields listed by the response came back empty for this source and input, so they are not shown.
Try it
Chess.com Published-Data API compared
What Chess.com Published-Data API says about its own limits, from its own page, read 19 November 2026:
- Serial access is unlimited; parallel requests may be rate limited.
When to use which. The official API is free and unlimited for one request at a time. FoxAPIs only helps if you want chess data in the same format and key as other platforms.
Limits and prices change; check the official page before you decide. Nothing here is an offer from Chess.com Published-Data API, and FoxAPIs is not affiliated with it.
What it costs for your volume
Calculated by us from the credits above and the plans listed on the pricing page.Formula
Other platforms: GitHub · Stack Overflow · Hacker News · CoinGecko · Steam · Apple App Store · FDA drug approvals · Mastodon · Twitch · all platforms · status
How we calculate
- Credits per 1,000 calls: The credits per call from the catalog times 1,000.
- Plan price per credit: The smallest paid plan's monthly price divided by its monthly credits.
Data: the FoxAPIs catalog and plans, read 2026-11-19. Every other figure on this page is copied from the record, not calculated by us.
Run this free, then pay per call
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire. Use them at your own pace. Get my free key
One call costs 1 credit. That is $7.96 per 1,000 calls on the Production plan and $9.80 on Builder (plan price divided by its monthly credits). The Free plan gives 100 credits a month with no card.
Building an AI agent?
- The FoxAPIs MCP server gives your agent every tool through one connection.
- Per-call pricing in credits: you pay for the calls your agent makes, with no seats.
- Free plan: 100 credits a month, no card, no monthly fee.