crob.at

Encontre, monte, analise e compartilhe times

Meus times

API do crob.at para desenvolvedores

Consulte, gere e compartilhe times Pokémon.
Integre a API ao seu aplicativo, bot ou outro projeto.

Uso gratuitoSem chave de APIRespostas em JSON

Crie seu primeiro time

Envie uma exportação do Pokémon Showdown.
Você receberá um link permanente para compartilhar.

  1. Envie seu timeEnvie um objeto JSON com o array teams e coloque a exportação em paste.
  2. 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.

POST/api/team
curl --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.

Usando um agente?

Forneça o guia e o esquema. Ambos funcionam sem JavaScript.

Guia em Markdown OpenAPI 3.1

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 retornar 200 com [].
  • 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 em Retry-After antes de fazer outra tentativa.
  • 500 ou 502: 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 cliente
  • POST /api/random-team/:format/save: 30 times aleatórios salvos por hora por cliente
  • POST /api/feedback: 5 mensagens por hora por cliente
  • Ao atingir o limite, a resposta usa o status HTTP 429 e inclui Retry-After. Os endpoints de escrita também retornam os cabeçalhos X-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/team aceita 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/feedback aceitam requisições de outras origens
  • /api/me e /api/showdown/assertion sã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.
  • Team e TeamInPaste: 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 opcionais message e retryAfter.

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.