O que a consulta retorna
Pesquise um nome de usuário do Chess.com e confira nome, título, país e perfil.
Campos que merecem atenção
- nome
- título
- país e perfil
Chess.com Published Data
Ajuda a conferir o perfil público de um jogador no Chess.com antes de abrir a página completa.
Buscar na API
Digite um termo real, veja a resposta da sua busca imediatamente:
Exemplos rápidos
Comece pelo nome de usuário, não pelo nome exibido
O endpoint /pub/player/{username} consulta uma conta pública pelo username. A resposta pode trazer username, player_id, url, name, title, followers, country, location, joined, last_online e status. name é um nome de exibição; para salvar uma referência ou montar uma nova consulta, prefira o username e guarde o player_id junto quando ele estiver disponível.
- Use o valor do username na URL, sem copiar espaços ou pontuação do nome exibido.
- Abra url para conferir a página pública antes de atribuir o perfil a uma pessoa.
- country pode vir como uma URL da própria API, e não como o nome do país.
Perfil e estatísticas respondem a perguntas diferentes
O perfil público descreve a conta. Para resultados por modalidade, use /pub/player/{username}/stats: uma resposta real trouxe blocos como chess_daily, chess_rapid, chess_bullet, chess_blitz, tactics e puzzle_rush, além de fide quando informado. Cada bloco pode ter campos próprios, como last, best ou record; não trate uma chave ausente como zero.
- Compare ratings apenas dentro da modalidade e da data que você está mostrando.
- Identifique claramente se um número veio de chess_rapid, chess_blitz ou outro bloco.
- Leia a resposta atual antes de montar campos fixos em uma interface.
Conta não encontrada é diferente de perfil incompleto
Para um username inexistente, o endpoint respondeu 404 com a mensagem de que o usuário não foi encontrado. Isso pede correção do identificador, não uma tentativa automática de adivinhar outra conta. Já um perfil existente pode não expor todos os campos vistos em outro perfil; trate cada campo como dado opcional e preserve o link de origem.
- Mostre uma mensagem clara para 404 e ofereça a correção do username.
- Não use followers, título ou streaming como prova de identidade fora do perfil conferido.
- Atualize dados salvos quando a data ou o perfil público for relevante para a tarefa.
