Forum

This may be super-trivial, but the only way I've figured out how to quickly convert a FEN to a playable URL is to start with the position, click "play from position", then retrieve the penultimate URL from browser history since there's a redirect for some reason.For example, a simple pawn vs king endgame shows the encoding is trivial (you can almost read the position straight from the URL -- %2F separates the files): https://www.chess.com/practice/custom?color=white&fen=6k1%2F8%2F8%2F8%2F8%2F3P4%2F8%2F3K4+w+-+-+0+1&is960=false&moveList=

This API endpoint returns an error for most of the clubs I've tested: {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."} Examples: https://api.chess.com/pub/club/promote-to-king/members https://api.chess.com/pub/club/oracles/members https://api.chess.com/pub/club/the-golden-phoenix/members https://api.chess.com/pub/club/turk-chess-players/members https://api.chess.com/pub/club/admin-s-corner-and-training-club/members https://api.chess.com/pub/club/1-d4-club/members Actually so far I only got it working for this very club.

Until recently I have had no problem with this end point for 'GB' although I am aware it will not work for 'US' due to the dataset size. Is this now becoming an issue for all larger country login member lists? Typically I would get between 130k - 170k logins in the dataset and that has been OK until now. https://api.chess.com/pub/country/GB/players Error 524 Ray ID: 6ba55c8fff3e7556 • 2021-12-08 10:39:39 UTC A timeout occurred

https://api.chess.com/pub/player/craneberry/games/2023/08 {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

This case is puzzling me... https://api.chess.com/pub/match/1103608 The webpage is fine: https://www.chess.com/club/matches/1103608 The match finished Dec 27, 2020 & I know I requested that endpoint yesterday and it returned the match data correctly but suddenly I'm getting this... {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

https://api.chess.com/pub/player/panzram666/matches  https://api.chess.com/pub/player/sergeledan/matches 

This.... https://api.chess.com/pub/club/team-morocco2 {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

I looked through the API documentation and there doesn't seem to be a way to download all the pgn's from the chess.com masters database: https://www.chess.com/games. The only other way is to manually download every single game with the download button, is there any workaround for this with the API possibly?

Is there some kind of limit to the number of games that can be returned from a monthly archive query? My archive for October 2023 is broken:https://api.chess.com/pub/player/whistlecube/games/2023/10But it worked fine a few weeks ago. Most other months work as expected, but a handful also give the same error. Any clue as to what's causing this? I'd love to help if possible.

I need to know a user's status or about me (bio) to get their discord. For vertification purposes I can say like "Set your chess.com profile status to your discord username." but I checked all Chess.com Unofficial API and there was status but it was account status (staff, closed, etc.) 

Probably not an API error but translates through to incorrect status for player in games archive. @risinghelios-inactive (renamed account) Shown as FPV in web page profile header, Games archive shows 'Account closed'. Wrong flag when renamed. API match results show status as 'closed' Example https://api.chess.com/pub/match/1564193 Bug report submitted 9th Oct.

Hi! I was wondering, is it was possible to get the PGN of a game that is currently in progress? I am using the python "chessdotcom" module. I can get the PGN of a completed game just fine, but I wanted to add a real-time mode to my app. If this is possible, what endpoint do I need to use? Are there any specific steps I need to take in order to set up the chessdotcom module?

Hi, I have a problem. I cant get results from all rounds from tournament. When I call:https://api.chess.com/pub/tournament/krakw---polish-chess-tour-1837419 In rounds section I got only 1 url: "rounds":["https://api.chess.com/pub/tournament/krakw---polish-chess-tour-1837419/7"]When I call for example: https://api.chess.com/pub/tournament/krakw---polish-chess-tour-1837419/1I got empty results. How get rounds 1,2 etc?

Hey folks, I'm playing the 2025 Daily Championship and thought it would be fun to poke around the data a little bit between rounds 1 and 2. It appears that some of the endpoints are broken - specifically the url for the tournament itself (https://api.chess.com/pub/tournament/2025-chess-com-daily-chess-championship-1) which yields an Internal Server Error, while the round 1 endpoint (https://api.chess.com/pub/tournament/2025-chess-com-daily-chess-championship-1/1) works, and for the groups I've only manually tried a handful, but it appears that the lower-numbered groups are broken (https://api.chess.com/pub/tournament/2025-chess-com-daily-chess-championship-1/1/1 and a few other small ones) and yield code 3024, "An internal error has occurred" and point to this forum for help. But any slightly larger group number I try seem to work fine - anything up to number 50 I've poked (non-exhaustively) is broken, but https://api.chess.com/pub/tournament/2025-chess-com-daily-chess-championship-1/1/60 and another bunch of large ones for example are fine.  I'm aware that the public API is no longer maintained now, but just wanted to mention this in case it gets looked at.  

Hi. I was wondering if a convenient method exists to find all my stats against chess masters. How many games did I win/lose/draw per given title? I know how to find all my games against them. I can perform a database search using chess.com's in-built tools. But how do I get these statistics without tediously downloading over 2000 games played against them and manually compiling these statistics?

Hello there! I would like to ask you a question: what is the cc API used for?

https://api.chess.com/pub/club/team-colombia {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

https://api.chess.com/pub/club/team-canada {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

https://api.chess.com/pub/club/pinoy-chess-philippines {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."}

https://api.chess.com/pub/player/cathateme {"code":0,"message":"An internal error has occurred. Please contact Chess.com Developer's Forum for further help https://www.chess.com/club/chess-com-developer-community ."} ...they shut your endpoint down 😉