API do crob.at para desenvolvedores
Consulte, gere e compartilhe times Pokémon.
Integre a API ao seu aplicativo, bot ou outro projeto.
Crie seu primeiro time
Envie uma exportação do Pokémon Showdown.
Você receberá um link permanente para compartilhar.
- Envie seu timeEnvie um objeto JSON com o array
teamse coloque a exportação empaste. - Compartilhe a URL retornadaMantenha o token de gerenciamento em sigilo.
URL da resposta
"url": "https://crob.at/abc123"Você receberá uma URL única.O exemplo salva um único Pokémon. Por padrão, o time fica fora das listas públicas, mas quem tiver o link pode acessá-lo.
/api/teamcurl --fail-with-body https://crob.at/api/team \
-H 'Content-Type: application/json' \
-d '{
"name": "My first team",
"teams": [{
"format": "gen9ou",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}'const base = 'https://crob.at';
const paste = [
'Garchomp @ Choice Scarf',
'Ability: Rough Skin',
'EVs: 252 Atk / 4 SpD / 252 Spe',
'Jolly Nature',
'- Earthquake',
'- Dragon Claw',
'- Stone Edge',
'- Iron Head'
].join('\n');
const createdResponse = await fetch(`${base}/api/team`, {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Example team',
public: false,
teams: [{format: 'gen9ou', paste}]
})
});
if (!createdResponse.ok) throw new Error(await createdResponse.text());
const created = await createdResponse.json();
console.log(created.url); // Share this URL, not management_token.
const teamResponse = await fetch(`${base}/api/team/${created.slug}`);
if (!teamResponse.ok) throw new Error(await teamResponse.text());
const team = await teamResponse.json();
console.log(team.teams[0].paste);Uma requisição bem-sucedida retorna 201 Created.
Forneça o guia e o esquema. Ambos funcionam sem JavaScript.
Referência da API
Escolha um endpoint para consultar campos da requisição, exemplos e respostas.
GETConsultar um time/api/team/:slug
Recupera um time pelo slug.
Exemplo:
curl https://crob.at/api/team/abc123
const response = await fetch('https://crob.at/api/team/abc123');
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data);
import requests
response = requests.get('https://crob.at/api/team/abc123')
response.raise_for_status()
data = response.json()
print(data)
Resposta:
{
"slug": "abc123",
"name": "My Team",
"author": "username",
"description": "Short notes about how the team plays.",
"public": false,
"provenance": null,
"format_status": null,
"tournament": null,
"image": "https://crob.at/og/abc123.png",
"source_url": null,
"created_at": "2026-07-21 10:30:00",
"views": 12,
"is_multi": false,
"teams": [{
"format": "gen9ou",
"name": "My Team",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}
GETConsultar um time de uma coleção/api/team/:slug/:teamSlug
Recupera um time de uma coleção. Use o slug do time no link de compartilhamento, como em /abc123/rain-offense.
Exemplo:
curl https://crob.at/api/team/abc123/rain-offense
Resposta:
{
"paste_slug": "abc123",
"slug": "rain-offense",
"format": "gen9ou",
"name": "Rain Offense",
"paste": "Pelipper @ Damp Rock\nAbility: Drizzle\n- Hurricane\n- Surf\n- U-turn\n- Roost",
"url": "https://crob.at/abc123/rain-offense",
"image": "https://crob.at/og/abc123.png?team=rain-offense"
}
POSTCompartilhar um time/api/team
Cria um novo time.
Requisição:
{
"name": "My Team Name",
"author": "username",
"description": "Short notes about how the team plays.",
"public": false,
"teams": [{
"name": "My Team",
"format": "gen9ou",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}
teams deve ter pelo menos uma entrada. Os nomes, o autor e a descrição são opcionais e são cortados se excederem o limite de tamanho. Se você informar um formato, o Pokémon Showdown deve aceitá-lo.
Exemplo:
curl -X POST https://crob.at/api/team \
-H "Content-Type: application/json" \
-d '{"name": "My Team", "description": "Fast offense with a Scarf cleaner.", "teams": [{"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"}]}'
const response = await fetch('https://crob.at/api/team', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'My Team',
description: 'Fast offense with a Scarf cleaner.',
teams: [{paste: 'Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head'}]
})
});
if (!response.ok) throw new Error(await response.text());
const {slug, url} = await response.json();
console.log(`Created: ${url}`);
import requests
response = requests.post('https://crob.at/api/team', json={
'name': 'My Team',
'description': 'Fast offense with a Scarf cleaner.',
'teams': [{'paste': 'Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head'}]
})
response.raise_for_status()
data = response.json()
print(f"Created: {data['url']}")
Resposta:
{
"slug": "abc123",
"url": "https://crob.at/abc123",
"image": "https://crob.at/og/abc123.png",
"management_token": "000000000000000000000000000000000000000000000000"
}
Retorna 201 quando o time é criado. O token do exemplo é fictício. Guarde o management_token real em um local seguro e compartilhe apenas a URL.
GETGerar um time/api/random-team/:format
Gera um time competitivo aleatório para um formato do Smogon. Retorna a exportação do Showdown e o HTML do cartão exibido no site. O time não é salvo. Alguns formatos do Showdown não têm dados para o gerador. O formato Random Battle do Showdown funciona separadamente. Confira se o time segue as regras do servidor em que você vai jogar.
Parâmetros de consulta opcionais: bias=staples|balanced|surprise, um nome de Pokémon para include e um nome para exclude . A ponderação padrão é balanced. Cada nome pode ter até 80 caracteres e deve estar na lista do gerador. Um Pokémon não pode ser incluído e excluído ao mesmo tempo. Codifique os nomes para uso na URL.
Exemplo:
curl https://crob.at/api/random-team/gen9ou
const response = await fetch('https://crob.at/api/random-team/gen9ou');
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data.teamText);
import requests
response = requests.get('https://crob.at/api/random-team/gen9ou')
response.raise_for_status()
data = response.json()
print(data['teamText'])
Resposta:
{
"teamText": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head\n\nCorviknight @ Leftovers\nAbility: Pressure\n- Roost\n- Defog\n- U-turn\n- Brave Bird\n\nRotom-Wash @ Leftovers\nAbility: Levitate\n- Hydro Pump\n- Volt Switch\n- Will-O-Wisp\n- Protect\n\nKingambit @ Black Glasses\nAbility: Supreme Overlord\n- Kowtow Cleave\n- Sucker Punch\n- Iron Head\n- Swords Dance\n\nClefable @ Leftovers\nAbility: Magic Guard\n- Moonblast\n- Moonlight\n- Stealth Rock\n- Thunder Wave\n\nDragapult @ Choice Specs\nAbility: Infiltrator\n- Shadow Ball\n- Draco Meteor\n- Flamethrower\n- U-turn",
"statsDate": "2026-03",
"cardsHtml": "<div class=\"pokemon-grid\">...</div>"
}
POSTSalvar um time gerado/api/random-team/:format/save
Cria um link permanente para um time gerado sem incluí-lo nas listas públicas. Envie o campo teamText retornado pelo gerador. Use a mesma chave idempotencyKey nas novas tentativas. Cada cliente pode salvar até 30 times por hora.
Exemplo:
const generatedResponse = await fetch('https://crob.at/api/random-team/gen9ou');
if (!generatedResponse.ok) throw new Error(await generatedResponse.text());
const generated = await generatedResponse.json();
// Keep this body unchanged if the save needs a retry.
const saveBody = JSON.stringify({
teamText: generated.teamText,
idempotencyKey: crypto.randomUUID()
});
const savedResponse = await fetch('https://crob.at/api/random-team/gen9ou/save', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: saveBody
});
if (!savedResponse.ok) throw new Error(await savedResponse.text());
console.log((await savedResponse.json()).url);
Resposta:
{
"slug": "rAbCdEf12345",
"url": "https://crob.at/rAbCdEf12345",
"image": "https://crob.at/og/rAbCdEf12345.png"
}
Retorna 201 ao salvar um novo time, 200 ao repetir uma requisição, 409 se a chave já foi usada com outros dados, 400 se o formato ou o time for inválido, 429 se o limite de requisições for atingido e 500 se não for possível salvar o time.
GETEncontrar times de exemplo/api/samples/:tier
Retorna os times de exemplo do Smogon para um formato. Os resultados ficam em cache por uma hora.
Exemplo:
curl https://crob.at/api/samples/gen9ou
const response = await fetch('https://crob.at/api/samples/gen9ou');
if (!response.ok) throw new Error(await response.text());
const teams = await response.json();
if (teams.length === 0) throw new Error('No sample teams available');
console.log(teams[0].url);
import requests
response = requests.get('https://crob.at/api/samples/gen9ou')
response.raise_for_status()
teams = response.json()
if not teams:
raise RuntimeError('No sample teams available')
print(teams[0]['url'])
Resposta:
[
{
"slug": "abc123",
"name": "Sun Offense",
"author": "Smogon",
"tier": "gen9ou",
"views": 142,
"created_at": "2026-01-15 10:00:00",
"url": "https://crob.at/abc123",
"image": "https://crob.at/og/abc123.png",
"source_url": "https://www.smogon.com/forums/..."
}
]
Retorna 400 se :tier contiver caracteres que não sejam letras ou números. Se não houver times de exemplo para o formato, retorna um array vazio.
GETConsultar tipos de Pokémon/api/type-chart-data
Retorna os nomes dos Pokémon com seu tipo ou seus dois tipos. Os resultados ficam em cache por 24 horas.
Exemplo:
curl https://crob.at/api/type-chart-data
Resposta:
[
["Bulbasaur", ["Grass", "Poison"]],
["Charmander", ["Fire"]]
]
GETConsultar o usuário conectado/api/me
Retorna o usuário com sessão ativa no crob.at, se houver. Este endpoint serve a interfaces da mesma origem que usam a sessão do navegador.
Exemplo:
curl https://crob.at/api/me \
-H "Cookie: session=your-session-cookie"
const response = await fetch('https://crob.at/api/me', {
credentials: 'include'
});
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data.user);
import requests
session = requests.Session()
session.cookies.set('session', 'your-session-cookie')
response = session.get('https://crob.at/api/me')
response.raise_for_status()
data = response.json()
print(data['user'])
Resposta:
{
"user": {
"username": "exampleuser",
"email": "[email protected]",
"ps_username": "ExampleUser",
"team_count": 7,
"favorite_count": 3
}
}
Retorna {"user": null} se não houver uma sessão válida do crob.at.
POSTEnviar feedback/api/feedback
Envia feedback sobre o produto com dados de contato opcionais. Cada mensagem pode ter até 2.000 caracteres, e cada cliente pode enviar até cinco mensagens por hora.
Exemplo:
curl -X POST https://crob.at/api/feedback \
-H "Content-Type: application/json" \
-d '{"message":"The team viewer is useful.","contact":"[email protected]"}'
Resposta:
{"success": true}
Retorna 400 se a mensagem estiver vazia ou for inválida, 429 se o limite de requisições for atingido e 500 se não for possível salvar o feedback.
POSTEntrar no Showdown pelo navegador/api/showdown/assertion
Função para navegadores da mesma origem. Requer uma sessão do crob.at vinculada ao Pokémon Showdown. Retorna o status HTTP 303 com o cabeçalho Location e um corpo vazio. O navegador precisa concluir a verificação do Showdown. A resposta não inclui uma asserção em JSON.
Esquema da requisição: ShowdownAssertionRequest.
{
"challstr": "12345|abcdefghijklmnopqrstuvwxyz"
}
A string do desafio deve ter de 1 a 2.048 caracteres, sem quebras de linha. Retorna 400 se a requisição for inválida, 401 se for necessário entrar com uma conta vinculada do Showdown e 503 se o OAuth do Showdown estiver indisponível. Bots que só consultam dados de times não precisam deste endpoint.
Informações úteis
Erros e novas tentativas
Confira o status HTTP antes de ler um campo da resposta de sucesso. Os erros em JSON incluem error e podem incluir message e retryAfter. Exemplo: {"error":"Rate limit exceeded","retryAfter":60}.
400: corrija o JSON, o texto do time, o formato ou a consulta antes de tentar novamente.404: o time ou os dados do gerador não estão disponíveis. Listas de times de exemplo podem retornar200com[].409: a chave para salvar um time gerado já foi usada com outros dados. Ao repetir a requisição, mantenha a mesma chave e o mesmo corpo.429: aguarde os segundos indicados emRetry-Afterantes de fazer outra tentativa.500ou502: limite as novas tentativas de leitura e aumente o intervalo entre elas. Se repetir uma gravação, mantenha o texto gerado.
POST /api/team e POST /api/feedback não aceitam chaves de idempotência. Se você não souber se a requisição chegou ao servidor, repeti-la pode criar uma duplicata. Cada requisição ao gerador produz um novo resultado aleatório.
Acesso e custo
Todas as operações documentadas são gratuitas. Os endpoints públicos não exigem conta, chave de API, forma de pagamento nem plano pago. Os recursos opcionais de conta e do Pokémon Showdown usam a sessão do crob.at no navegador.
Limites de requisições
POST /api/team: 500 times criados por hora por clientePOST /api/random-team/:format/save: 30 times aleatórios salvos por hora por clientePOST /api/feedback: 5 mensagens por hora por cliente- Ao atingir o limite, a resposta usa o status HTTP
429e incluiRetry-After. Os endpoints de escrita também retornam os cabeçalhosX-RateLimit-*aplicáveis.
Termos de uso da API
Use a API de forma legal e sem prejudicar o crob.at ou outros usuários. Não burle os limites de requisições, não procure dados privados e não envie conteúdo abusivo ou que viole direitos. Não alegue falsamente que o crob.at, o Pokémon Showdown, a Nintendo, a Game Freak ou a The Pokémon Company endossam sua integração. Quem publica um time responde por seu conteúdo. A API é oferecida conforme a disponibilidade, sem garantia de nível de serviço, e pode mudar. Mudanças relevantes no contrato estarão no documento OpenAPI e no histórico do repositório. A política de privacidade explica como o crob.at trata dados de contas e requisições.
Segurança
Os endpoints públicos são anônimos e dispensam chave. Os endpoints autenticados usam uma sessão segura do crob.at no navegador e atuam somente na conta conectada. Nunca envie um cookie de sessão do crob.at para outra origem nem o inclua em código do cliente. Para relatar uma vulnerabilidade em particular, escreva para [email protected] com os passos para reproduzi-la. Não acesse nem altere dados de terceiros.
Requisitos e compatibilidade
- Os times devem usar o formato de exportação do Pokémon Showdown
POST /api/teamaceita apenas JSON- O texto dos times pode ter até 500.000 caracteres por requisição
- Você pode enviar uma exportação com um ou mais times
/api/team,/api/team/:slug,/api/team/:slug/:teamSlug,/api/random-team/:format,/api/random-team/:format/save,/api/samples/:tier,/api/type-chart-datae/api/feedbackaceitam requisições de outras origens/api/mee/api/showdown/assertionsão endpoints que usam a sessão do navegador para a interface e a autenticação do crob.at
Esquemas e guias para agentes
Baixe /openapi.json antes de gerar um cliente. O campo jsonSchemaDialect contém https://json-schema.org/draft/2020-12/schema. Resolva as referências locais $ref no próprio documento. O arquivo completo segue o padrão OpenAPI. Os esquemas de requisição e resposta estão em components.schemas.
CreateTeamRequest→CreatedTeam: criar uma coleção de times.TeameTeamInPaste: consultar uma coleção ou um de seus times.GeneratedTeam: exportação gerada, mês das estatísticas de uso e HTML para exibir o time.SaveGeneratedTeamRequest→CreatedTeam: salvar uma exportação gerada.Error: texto do erro com os campos opcionaismessageeretryAfter.
O esquema indica os campos obrigatórios. Alguns campos da resposta podem conter null. Aceite campos adicionais na resposta. Os esquemas JSON descrevem a estrutura dos dados. O servidor também confere se o texto pode ser lido como um time Pokémon, se os formatos são aceitos e se o texto respeita o limite de tamanho total.
Outros arquivos de documentação: requisitos de acesso e de conta, APIs.jsone catálogo da API.