Skip to main content
GET
Returns the Chess.com profile of a player (ratings, clubs) and any records about the account found in the Chess.com leak.

Parameters

string
required
A Chess.com username or an e-mail address.

Headers

string
required
Your API key.

Usage

Counts as one lookup against your plan’s daily allowance (Max: unlimited). When the allowance is used up, the lookup can continue at a per-lookup price charged to your balance (the module’s page in the dashboard shows the price); a lookup that finds nothing is not charged.

Example request

Response

boolean
true when the lookup ran.
boolean
Whether anything was found.
string
The query.
string
The username the lookup settled on.
object
The public profile (name, country, joined, last online, followers …), or null.
object
Ratings: rapid, blitz, bullet, fide (each null when unrated).
array
Up to 10 clubs.
array
Records from the Chess.com leak.
number
Number of leak records.

Errors

See Errors for the responses every endpoint can return.