crob.at

Trouvez, créez, analysez et partagez des équipes

Mes équipes

L’API crob.at pour tes projets

Récupère, génère et partage des équipes Pokémon.
Intègre l’API à ton application, à ton bot ou à un autre projet.

GratuiteSans clé d’APIRéponses JSON

Crée ta première équipe

Envoie un export Pokémon Showdown.
Tu recevras un lien permanent à partager.

  1. Envoie ton équipeEnvoie un objet JSON avec le tableau teams et place l’export dans paste.
  2. Partage l’URL reçueGarde le jeton de gestion pour toi.

URL de la réponse

"url": "https://crob.at/abc123"Tu recevras une URL unique.

L’exemple enregistre un seul Pokémon. Par défaut, l’équipe n’apparaît pas dans les listes publiques, mais toute personne ayant le lien peut la consulter.

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 requête réussit, le serveur renvoie 201 Created.

Tu utilises un agent ?

Donne-lui le guide et le schéma. Les deux sont accessibles sans JavaScript.

Guide en Markdown OpenAPI 3.1

Référence de l’API

Choisis un point de terminaison pour consulter les champs de requête, les exemples et les réponses.

GETRécupérer une équipe/api/team/:slug

Récupère une équipe à partir de son identifiant dans l’URL.

Exemple :

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)

Réponse :

{
  "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"
  }]
}
GETRécupérer une équipe d’une collection/api/team/:slug/:teamSlug

Récupère une équipe dans un export qui en contient plusieurs. Utilise l’identifiant de l’équipe dans le lien de partage, par exemple /abc123/rain-offense.

Exemple :

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

Réponse :

{
  "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"
}
POSTPartager une équipe/api/team

Crée une équipe.

Requête :

{
  "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 doit contenir au moins une entrée. Les noms, l’auteur et la description sont facultatifs et sont tronqués s’ils dépassent la longueur maximale. Si tu indiques un format, il doit être pris en charge par Pokémon Showdown.

Exemple :

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

Réponse :

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

Renvoie 201 à la création de l’équipe. Le jeton de l’exemple est fictif. Garde la vraie valeur management_token en lieu sûr et partage uniquement l’URL.

GETGénérer une équipe/api/random-team/:format

Génère une équipe compétitive aléatoire pour un format Smogon. Renvoie l’export Showdown et le HTML de la carte affichée sur le site. L’équipe n’est pas enregistrée. Le générateur ne dispose pas de données pour tous les formats Showdown. Le format Random Battle de Showdown fonctionne séparément. Vérifie que l’équipe respecte les règles du serveur où tu veux jouer.

Paramètres de requête facultatifs : bias=staples|balanced|surprise, un nom de Pokémon pour include et un nom de Pokémon pour exclude . La pondération par défaut est balanced. Chaque nom doit comporter au plus 80 caractères et figurer dans la liste du générateur. Tu ne peux pas inclure et exclure le même Pokémon. Encode les noms pour l’URL.

Exemple :

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

Réponse :

{
  "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>"
}
POSTEnregistrer une équipe générée/api/random-team/:format/save

Crée un lien permanent pour une équipe générée sans l’ajouter aux listes publiques. Envoie le champ teamText renvoyé par le générateur. Réutilise la même valeur de idempotencyKey si tu dois réessayer. Chaque client peut enregistrer jusqu’à 30 équipes par heure.

Exemple :

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

Réponse :

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

Renvoie 201 pour un nouvel enregistrement, 200 pour une nouvelle tentative, 409 si la clé a déjà servi pour d’autres données, 400 si le format ou l’équipe est invalide, 429 si la limite de requêtes est atteinte, et 500 si l’équipe ne peut pas être enregistrée.

GETTrouver des exemples d’équipes/api/samples/:tier

Renvoie les exemples d’équipes de Smogon pour un format donné. Les résultats sont mis en cache pendant une heure.

Exemple :

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

Réponse :

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

Renvoie 400 si :tier contient des caractères autres que des lettres ou des chiffres. Renvoie un tableau vide si le format ne propose aucun exemple d’équipe.

GETRécupérer les types des Pokémon/api/type-chart-data

Renvoie le nom de chaque Pokémon avec son type ou ses deux types. Les résultats sont mis en cache pendant 24 heures.

Exemple :

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

Réponse :

[
  ["Bulbasaur", ["Grass", "Poison"]],
  ["Charmander", ["Fire"]]
]
GETRécupérer l’utilisateur connecté/api/me

Renvoie l’utilisateur connecté à crob.at, s’il y en a un. Ce point de terminaison est destiné aux interfaces de même origine qui utilisent la session du navigateur.

Exemple :

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

Réponse :

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

Renvoie {"user": null} si aucune session crob.at valide n’est active.

POSTEnvoyer un commentaire/api/feedback

Envoie un commentaire sur le produit avec des coordonnées facultatives. Chaque message peut contenir jusqu’à 2 000 caractères et chaque client peut en envoyer cinq par heure.

Exemple :

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

Réponse :

{"success": true}

Renvoie 400 si le message est vide ou invalide, 429 si la limite de requêtes est atteinte, et 500 si le commentaire ne peut pas être enregistré.

POSTConnexion à Showdown dans le navigateur/api/showdown/assertion

Fonction réservée aux navigateurs de même origine. Elle nécessite une session crob.at liée à Pokémon Showdown. Elle renvoie le statut HTTP 303 avec l’en-tête Location et un corps vide. Le navigateur doit terminer la vérification auprès de Showdown. La réponse ne contient pas d’assertion JSON.

Schéma de la requête : ShowdownAssertionRequest.

{
  "challstr": "12345|abcdefghijklmnopqrstuvwxyz"
}

La chaîne du défi doit contenir de 1 à 2 048 caractères, sans saut de ligne. La réponse est 400 si la requête est invalide, 401 si une connexion à un compte Showdown lié est nécessaire, et 503 si OAuth de Showdown est indisponible. Les bots qui consultent uniquement les données d’équipe n’ont pas besoin de ce point de terminaison.

À savoir

Erreurs et nouvelles tentatives

Vérifie le statut HTTP avant de lire un champ de réponse en cas de succès. Les erreurs JSON contiennent error et peuvent contenir message et retryAfter. Par exemple : {"error":"Rate limit exceeded","retryAfter":60}.

  • 400 : corrige le JSON, le texte de l’équipe, le format ou la requête avant de réessayer.
  • 404 : l’équipe ou les données du générateur sont indisponibles. Les listes d’exemples d’équipes peuvent renvoyer 200 avec [].
  • 409 : la clé d’enregistrement d’une équipe générée a déjà servi pour d’autres données. Réutilise la même clé et le même corps lors d’une nouvelle tentative.
  • 429 : attends le nombre de secondes indiqué par Retry-After avant de réessayer.
  • 500 ou 502 : limite le nombre de nouvelles tentatives de lecture et augmente le délai entre elles. Si tu réessaies un enregistrement, garde le texte généré.

POST /api/team et POST /api/feedback n’acceptent pas de clés d’idempotence. Si tu ignores si le serveur a reçu une requête, la répéter peut créer un doublon. Chaque requête au générateur produit un nouveau résultat aléatoire.

Accès et prix

Toutes les opérations documentées sont gratuites. Les points de terminaison publics sont accessibles sans compte, clé d’API, moyen de paiement ni abonnement. Les fonctions facultatives liées au compte et à Pokémon Showdown utilisent la session crob.at du navigateur.

Limites de requêtes
  • POST /api/team : 500 équipes créées par heure et par client
  • POST /api/random-team/:format/save : 30 équipes aléatoires enregistrées par heure et par client
  • POST /api/feedback : 5 messages par heure et par client
  • Lorsque la limite est atteinte, la réponse utilise le statut HTTP 429 et inclut Retry-After. Les points de terminaison d’écriture fournissent aussi les en-têtes X-RateLimit-* applicables.
Conditions d’utilisation de l’API

Utilise l’API conformément à la loi, sans perturber crob.at ni ses autres utilisateurs. Ne contourne pas les limites de requêtes, ne cherche pas à accéder à des données privées et n’envoie aucun contenu abusif ou portant atteinte aux droits de tiers. Ne prétends pas que crob.at, Pokémon Showdown, Nintendo, Game Freak ou The Pokémon Company soutiennent ton intégration. Le contenu d’une équipe publique relève de la responsabilité de la personne qui l’a soumise. L’API est fournie selon sa disponibilité, sans garantie de niveau de service, et peut évoluer. Les changements importants du contrat figureront dans le document OpenAPI et l’historique du dépôt. La politique de confidentialité explique comment crob.at traite les données de compte et de requête.

Sécurité

Les points de terminaison publics sont anonymes et accessibles sans clé. Les points de terminaison authentifiés utilisent une session crob.at sécurisée dans le navigateur et agissent uniquement sur le compte connecté. N’envoie jamais de cookie de session crob.at vers une autre origine et ne l’intègre pas au code client. Pour signaler une vulnérabilité de manière privée, écris à [email protected] en indiquant comment la reproduire. N’accède pas aux données de tiers et ne les modifie pas.

Conditions et compatibilité
  • Les équipes doivent suivre le format d’export de Pokémon Showdown
  • POST /api/team accepte uniquement du JSON
  • Le texte des équipes peut contenir jusqu’à 500 000 caractères par requête
  • Tu peux envoyer un export contenant une ou plusieurs équipes
  • /api/team, /api/team/:slug, /api/team/:slug/:teamSlug, /api/random-team/:format, /api/random-team/:format/save, /api/samples/:tier, /api/type-chart-dataet /api/feedback acceptent les requêtes provenant d’autres origines
  • /api/me et /api/showdown/assertion sont des points de terminaison qui utilisent la session du navigateur pour l’interface et l’authentification de crob.at
Schémas et guides pour les agents

Récupère /openapi.json avant de générer un client. Le champ jsonSchemaDialect indique https://json-schema.org/draft/2020-12/schema. Résous les références locales $ref dans le document lui-même. Le fichier complet est un document OpenAPI. Les schémas de requête et de réponse se trouvent dans components.schemas.

  • CreateTeamRequest → CreatedTeam : créer une collection d’équipes.
  • Team et TeamInPaste : récupérer une collection ou une équipe qui en fait partie.
  • GeneratedTeam : export généré, mois des statistiques d’utilisation et HTML d’affichage.
  • SaveGeneratedTeamRequest → CreatedTeam : enregistrer un export généré.
  • Error : texte de l’erreur avec les champs facultatifs message et retryAfter.

Le schéma indique les champs obligatoires. Certains champs de réponse peuvent valoir null. Accepte les champs supplémentaires dans les réponses. Les schémas JSON décrivent la structure des données. Le serveur vérifie aussi que le texte peut être lu comme une équipe Pokémon, que les formats sont pris en charge et que le texte respecte la longueur totale maximale.

Autres fichiers de documentation : conditions d’accès et de compte, APIs.jsonet catalogue d’API.