crob.at

Busca, crea, analiza y comparte equipos

Mis equipos

API de crob.at para desarrolladores

Consulta, genera y comparte equipos Pokémon.
Integra la API en tu aplicación, bot u otro proyecto.

Uso gratuitoSin clave de APIRespuestas en JSON

Crea tu primer equipo

Envía una exportación de Pokémon Showdown.
Recibirás un enlace permanente para compartir.

  1. Envía tu equipoEnvía un objeto JSON con el array teams y coloca la exportación en paste.
  2. Comparte la URL recibidaMantén en privado el token de gestión.

URL de la respuesta

"url": "https://crob.at/abc123"Recibirás una URL única.

El ejemplo guarda un solo Pokémon. Por defecto, el equipo no aparece en listas públicas, pero cualquiera con el enlace puede abrirlo.

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);

Si la solicitud tiene éxito, la respuesta es 201 Created.

¿Usas un agente?

Facilítale la guía y el esquema. Ambos funcionan sin JavaScript.

Guía en Markdown OpenAPI 3.1

Referencia de la API

Elige un endpoint para consultar sus campos de solicitud, ejemplos y respuestas.

GETConsultar un equipo/api/team/:slug

Recupera un equipo por su slug.

Ejemplo:

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)

Respuesta:

{
  "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 un equipo de una colección/api/team/:slug/:teamSlug

Recupera un equipo de una colección. Usa el slug del equipo que aparece en su enlace, por ejemplo /abc123/rain-offense.

Ejemplo:

curl https://crob.at/api/team/abc123/rain-offense

Respuesta:

{
  "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"
}
POSTCompartir un equipo/api/team

Crea un equipo nuevo.

Solicitud:

{
  "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 debe contener al menos una entrada. Los nombres, el autor y la descripción son opcionales y se recortan si superan el límite de longitud. Si indicas un formato, Pokémon Showdown debe admitirlo.

Ejemplo:

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']}")

Respuesta:

{
  "slug": "abc123",
  "url": "https://crob.at/abc123",
  "image": "https://crob.at/og/abc123.png",
  "management_token": "000000000000000000000000000000000000000000000000"
}

Devuelve 201 al crear el equipo. El token del ejemplo es ficticio. Guarda el management_token real en un lugar seguro y comparte solo la URL.

GETGenerar un equipo/api/random-team/:format

Genera un equipo competitivo aleatorio para un formato de Smogon. Devuelve el texto para Showdown y el HTML de la tarjeta que usa el sitio. El equipo no se guarda. Algunos formatos de Showdown no tienen datos para el generador. El formato Random Battle de Showdown funciona por separado. Comprueba que el equipo cumpla las reglas del servidor donde vayas a jugar.

Parámetros de consulta opcionales: bias=staples|balanced|surprise, un nombre de Pokémon para include y otro para exclude . La ponderación predeterminada es balanced. Cada nombre puede tener hasta 80 caracteres y debe estar en la lista del generador. No incluyas y excluyas al mismo Pokémon. Codifica los nombres para la URL.

Ejemplo:

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'])

Respuesta:

{
  "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>"
}
POSTGuardar un equipo generado/api/random-team/:format/save

Crea un enlace permanente para un equipo generado sin incluirlo en los listados públicos. Envía el campo teamText que devuelve el generador. Reutiliza el mismo idempotencyKey en los reintentos. Cada cliente puede guardar hasta 30 equipos por hora.

Ejemplo:

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);

Respuesta:

{
  "slug": "rAbCdEf12345",
  "url": "https://crob.at/rAbCdEf12345",
  "image": "https://crob.at/og/rAbCdEf12345.png"
}

Devuelve 201 al guardar un equipo nuevo, 200 al repetir una solicitud, 409 si la clave ya se usó con otros datos, 400 si el formato o el equipo no es válido, 429 si se supera el límite de solicitudes y 500 si no se puede guardar el equipo.

GETBuscar equipos de ejemplo/api/samples/:tier

Devuelve los equipos de ejemplo de Smogon para un formato. Los resultados se guardan en caché durante una hora.

Ejemplo:

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'])

Respuesta:

[
  {
    "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/..."
  }
]

Devuelve 400 si :tier contiene caracteres que no sean letras o números. Si el formato no tiene equipos de ejemplo, devuelve un array vacío.

GETConsultar los tipos Pokémon/api/type-chart-data

Devuelve los nombres de los Pokémon junto con su tipo o ambos tipos. Los resultados se guardan en caché durante 24 horas.

Ejemplo:

curl https://crob.at/api/type-chart-data

Respuesta:

[
  ["Bulbasaur", ["Grass", "Poison"]],
  ["Charmander", ["Fire"]]
]
GETConsultar el usuario conectado/api/me

Devuelve el usuario de crob.at con sesión iniciada, si lo hay. Este endpoint está pensado para interfaces del mismo origen que usan la sesión del navegador.

Ejemplo:

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'])

Respuesta:

{
  "user": {
    "username": "exampleuser",
    "email": "[email protected]",
    "ps_username": "ExampleUser",
    "team_count": 7,
    "favorite_count": 3
  }
}

Devuelve {"user": null} si no hay una sesión válida de crob.at.

POSTEnviar comentarios/api/feedback

Envía comentarios sobre el producto con datos de contacto opcionales. Cada mensaje puede tener hasta 2000 caracteres y cada cliente puede enviar hasta cinco mensajes por hora.

Ejemplo:

curl -X POST https://crob.at/api/feedback \
  -H "Content-Type: application/json" \
  -d '{"message":"The team viewer is useful.","contact":"[email protected]"}'

Respuesta:

{"success": true}

Devuelve 400 si el mensaje está vacío o no es válido, 429 si se supera el límite de solicitudes y 500 si no se puede guardar el comentario.

POSTIniciar sesión en Showdown desde el navegador/api/showdown/assertion

Función para navegadores del mismo origen. Requiere una sesión de crob.at vinculada a Pokémon Showdown. Devuelve el estado HTTP 303 con la cabecera Location y un cuerpo vacío. El navegador debe completar la verificación de Showdown. No se devuelve una afirmación en JSON.

Esquema de la solicitud: ShowdownAssertionRequest.

{
  "challstr": "12345|abcdefghijklmnopqrstuvwxyz"
}

La cadena del desafío debe tener entre 1 y 2048 caracteres y no puede incluir saltos de línea. Devuelve 400 si la solicitud no es válida, 401 si es necesario iniciar sesión con una cuenta de Showdown vinculada y 503 si OAuth de Showdown no está disponible. Los bots que solo consultan equipos no necesitan este endpoint.

Información práctica

Errores y reintentos

Comprueba el estado HTTP antes de leer un campo de una respuesta correcta. Los errores JSON incluyen error y pueden incluir message y retryAfter. Por ejemplo: {"error":"Rate limit exceeded","retryAfter":60}.

  • 400: corrige el JSON, el texto del equipo, el formato o la consulta antes de volver a intentarlo.
  • 404: el equipo o los datos del generador no están disponibles. Las listas de equipos de ejemplo pueden devolver 200 con [].
  • 409: la clave para guardar un equipo generado ya se usó con otros datos. Conserva la misma clave y el mismo cuerpo al repetir la solicitud.
  • 429: espera los segundos que indica Retry-After antes de volver a intentarlo.
  • 500 o 502: limita los reintentos de lectura y aumenta el tiempo de espera entre ellos. Si repites una solicitud de guardado, conserva el texto generado.

POST /api/team y POST /api/feedback no admiten claves de idempotencia. Si no sabes si una solicitud llegó al servidor, repetirla puede crear un duplicado. Cada solicitud de generación produce un resultado aleatorio nuevo.

Acceso y coste

Todas las operaciones documentadas son gratuitas. Los endpoints públicos funcionan sin cuenta, clave, método de pago ni plan de pago. Las funciones opcionales de cuenta y Pokémon Showdown usan la sesión de crob.at en el navegador.

Límites de solicitudes
  • POST /api/team: 500 equipos creados por hora y cliente
  • POST /api/random-team/:format/save: 30 equipos aleatorios guardados por hora y cliente
  • POST /api/feedback: 5 mensajes por hora y cliente
  • Si se alcanza un límite, la respuesta usa el estado HTTP 429 e incluye Retry-After. Los endpoints de escritura también devuelven las cabeceras X-RateLimit-* que correspondan.
Condiciones de uso de la API

Usa la API de forma lícita y sin perjudicar a crob.at ni a otros usuarios. No eludas los límites de solicitudes, busques datos privados ni envíes contenido abusivo o que infrinja derechos. No afirmes falsamente que crob.at, Pokémon Showdown, Nintendo, Game Freak o The Pokémon Company respaldan tu integración. Quien publique un equipo es responsable de su contenido. La API se ofrece según disponibilidad, sin garantía de nivel de servicio, y puede cambiar. Los cambios importantes del contrato se indicarán en el documento OpenAPI y en el historial del repositorio. La política de privacidad explica cómo trata crob.at los datos de cuentas y solicitudes.

Seguridad

Los endpoints públicos son anónimos y no requieren clave. Los endpoints que requieren autenticación usan una sesión segura de crob.at en el navegador y actúan solo sobre la cuenta que ha iniciado sesión. No envíes una cookie de sesión de crob.at a otro origen ni la incluyas en código del cliente. Para informar de una vulnerabilidad en privado, escribe a [email protected] e indica cómo reproducirla. No accedas a datos ajenos ni los modifiques.

Requisitos y compatibilidad
  • Los equipos deben usar el formato de exportación de Pokémon Showdown
  • POST /api/team solo acepta JSON
  • El texto de los equipos puede tener hasta 500 000 caracteres por solicitud
  • Puedes enviar una exportación con uno o varios equipos
  • /api/team, /api/team/:slug, /api/team/:slug/:teamSlug, /api/random-team/:format, /api/random-team/:format/save, /api/samples/:tier, /api/type-chart-datay /api/feedback admiten solicitudes de otros orígenes
  • /api/me y /api/showdown/assertion son endpoints que usan la sesión del navegador para la interfaz y la autenticación de crob.at
Esquemas y guías para agentes

Descarga /openapi.json antes de generar un cliente. El campo jsonSchemaDialect indica https://json-schema.org/draft/2020-12/schema. Resuelve las referencias locales $ref en el propio documento. El archivo completo sigue el estándar OpenAPI. Los esquemas de solicitudes y respuestas están en components.schemas.

  • CreateTeamRequest → CreatedTeam: crear una colección de equipos.
  • Team y TeamInPaste: consultar una colección o uno de sus equipos.
  • GeneratedTeam: exportación generada, mes de las estadísticas de uso y HTML para mostrar el equipo.
  • SaveGeneratedTeamRequest → CreatedTeam: guardar una exportación generada.
  • Error: texto del error con los campos opcionales message y retryAfter.

El esquema indica los campos obligatorios. Algunos campos de respuesta pueden contener null. Admite campos adicionales en las respuestas. Los esquemas JSON describen la estructura de los datos. El servidor también comprueba que el texto se pueda leer como un equipo Pokémon, que los formatos sean compatibles y que el texto no supere la longitud máxima total.

Otros archivos de documentación: requisitos de acceso y de cuenta, APIs.jsony catálogo de la API.