Skip to content

Chess.com API

Chess.com (chess.com) has 3 public methods: list recent games, get player stats and list top players. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

chess.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by Chess.com.

Methods

3

  • List recent games

    Lists a Chess.com player's completed public games for a month, newest first, with results, ratings, opening and game links.

    Returns games with end time, color, ratings, opponent, result, how it ended, time control, opening, game link, PGN and final position

    Readchess.com/list_recent_games

  • Get player stats

    Gets a Chess.com player's public profile, ratings and game records, best puzzle rating and Puzzle Rush best score from a username or member profile link.

    Returns username, display name, title, country, dates, followers, profile and avatar links, rapid/blitz/bullet/daily ratings and records, best puzzle rating, Puzzle Rush best score

    Readchess.com/get_player_stats

  • List top players

    Lists up to 50 top Chess.com players for a time control, in rank order, with ratings, game records and profile links. Puzzles rankings use puzzle scores.

    Returns rank, username, name, title, country, rating, wins, losses, draws, profile link

    Readchess.com/list_top_players