What the response contains
Try magnuscarlsen, hikaru, and fabianocaruana and use the returned fields to identify the right record.
Fields worth checking
- Games & Sports
- Chess.com Published Data results
- public source
Chess.com Published Data
Games & Sports · Chess.com Published Data results · public source
Live lookup
Type a real query, scan the cards and confirm the key details before opening the full source.
Quick examples
Start with the username, not the display name
The /pub/player/{username} endpoint looks up a public account by username. Its response can include username, player_id, url, name, title, followers, country, location, joined, last_online, and status. name is a display name; when saving a reference or building another request, prefer username and keep player_id alongside it when available.
- Use the username value in the URL instead of copying spaces or punctuation from a display name.
- Open url to check the public page before attributing a profile to a person.
- country can be an API URL rather than a country name.
Profile and statistics answer different questions
The public profile describes the account. For results by game type, use /pub/player/{username}/stats: a live response contained blocks such as chess_daily, chess_rapid, chess_bullet, chess_blitz, tactics, and puzzle_rush, as well as fide when supplied. Each block can have its own fields, such as last, best, or record; do not interpret an absent key as zero.
- Compare ratings only within the game type and date you show.
- State clearly whether a number comes from chess_rapid, chess_blitz, or another block.
- Read the current response before building fixed fields into an interface.
An unknown account differs from an incomplete profile
For a nonexistent username, the endpoint returned 404 with a user-not-found message. That calls for correcting the identifier, not automatically guessing another account. An existing profile may not expose every field seen on another profile; treat every field as optional data and retain the source link.
- Show a clear message for 404 and offer to correct the username.
- Do not use followers, title, or streaming as identity proof beyond the checked profile.
- Refresh stored data when the date or public profile matters to the task.