Home · Platforms · Chess.com

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

EndpointCredits a callCredits per 1,000 calls
POST /v1/gaming/chess/player11,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)

FieldTypeValue in that response
platformstringchess.com
usernamestringhikaru
titlestringGM
namestringHikaru Nakamura
countrystringUS
locationstringFlorida
joined_datestring2014-01-06
last_onlinestring2026-11-18
is_streamerbooleantrue
verifiedbooleanfalse
leaguestringLegend
followersnumber1435111
bulletobject{"current_rating":3402,"best_rating":3570,"best_game_url":"https://www.chess.com/game/live/5710095242","win...
blitzobject{"current_rating":3453,"best_rating":3503,"best_game_url":"https://www.chess.com/game/live/184580310677","w...
rapidobject{"current_rating":2838,"best_rating":2927,"best_game_url":"https://www.chess.com/game/live/141332265952","w...
dailyobject{"current_rating":2239,"best_rating":2464,"best_game_url":"https://www.chess.com/game/daily/84604826","wins...
chess960_dailyobject{"current_rating":1231,"best_rating":1489,"best_game_url":"https://www.chess.com/game/daily/87191830","wins...
tactics_ratingnumber2730
puzzle_rush_bestnumber123
profile_urlstringhttps://www.chess.com/member/Hikaru
avatarstringhttps://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png
time_controls_glossaryobject{"bullet":"1-2 minutes per game","blitz":"3-5 minutes per game","rapid":"10-25 minutes per game","daily":"1...
errorslist[]
credits_usednumber1

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:

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

Start free: get a key

Other platforms: GitHub · Stack Overflow · Hacker News · CoinGecko · Steam · Apple App Store · FDA drug approvals · Mastodon · Twitch · all platforms · status

How we calculate

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.

Run this freeBuy credits

Building an AI agent?

See the MCP server