crob.at

Teams suchen, erstellen, analysieren und teilen

Meine Teams

Die API von crob.at für dein Projekt

Rufe Pokémon-Teams ab, generiere sie und teile sie.
Binde die API in deine App, deinen Bot oder ein anderes Projekt ein.

KostenlosOhne API-SchlüsselJSON-Antworten

Erstelle dein erstes Team

Sende einen Pokémon-Showdown-Export.
Du erhältst einen dauerhaften Link zum Teilen.

  1. Team sendenSende ein JSON-Objekt mit dem Array teams und speichere den Export in paste.
  2. Erhaltene URL teilenHalte das Verwaltungstoken geheim.

URL in der Antwort

"url": "https://crob.at/abc123"Du erhältst eine eindeutige URL.

Das Beispiel speichert ein einzelnes Pokémon. Teams erscheinen standardmäßig in keiner öffentlichen Liste. Jeder mit dem Link kann sie abrufen.

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

Bei Erfolg lautet der Antwortstatus 201 Created.

Du arbeitest mit einem Agenten?

Gib ihm die Anleitung und das Schema. Beides ist ohne JavaScript verfügbar.

Markdown-Anleitung OpenAPI 3.1

API-Referenz

Wähle einen Endpunkt, um Anfragefelder, Beispiele und Antworten zu sehen.

GETTeam abrufen/api/team/:slug

Ruft ein Team anhand seines Slugs ab.

Beispiel:

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)

Antwort:

{
  "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"
  }]
}
GETTeam aus einer Sammlung abrufen/api/team/:slug/:teamSlug

Ruft ein Team aus einer Sammlung ab. Verwende den Slug des einzelnen Teams im Freigabelink, zum Beispiel /abc123/rain-offense.

Beispiel:

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

Antwort:

{
  "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"
}
POSTTeam teilen/api/team

Erstellt ein neues Team.

Anfrage:

{
  "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 muss mindestens einen Eintrag enthalten. Namen, Autor und Beschreibung sind optional und werden bei Bedarf gekürzt. Wenn du ein Format angibst, muss Pokémon Showdown es unterstützen.

Beispiel:

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

Antwort:

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

Antwort: 201 bei erfolgreicher Erstellung. Das Token im Beispiel ist ein Platzhalter. Bewahre das echte management_token sicher auf und teile nur die URL.

GETTeam generieren/api/random-team/:format

Generiert ein zufälliges Wettkampfteam für ein Smogon-Format. Die Antwort enthält den Showdown-Export und das HTML der Teamkarte auf der Website. Die Anfrage speichert kein Team. Für einige Showdown-Formate fehlen Generatordaten. Das Random-Battle-Format von Showdown funktioniert separat. Prüfe, ob das Team den Regeln deines Kampfservers entspricht.

Optionale Abfrageparameter: bias=staples|balanced|surprise, ein Pokémon-Name für include und ein Pokémon-Name für exclude . Die Standardgewichtung ist balanced. Jeder Name darf höchstens 80 Zeichen enthalten und muss im Generatorpool vorkommen. Du kannst ein Pokémon nicht zugleich ein- und ausschließen. Kodiere die Namen für die URL.

Beispiel:

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

Antwort:

{
  "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>"
}
POSTGeneriertes Team speichern/api/random-team/:format/save

Erstellt einen dauerhaften Link für ein generiertes Team, ohne es öffentlich aufzulisten. Sende das Feld teamText aus der Antwort des Generators. Verwende denselben idempotencyKey bei erneuten Versuchen. Jeder Client kann bis zu 30 Teams pro Stunde speichern.

Beispiel:

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

Antwort:

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

Antwort: 201 beim Speichern eines neuen Teams, 200 bei Wiederholung derselben Anfrage, 409 wenn der Schlüssel bereits mit anderen Eingabedaten verwendet wurde, 400 bei einem ungültigen Format oder Team, 429 bei Erreichen des Anfragelimits und 500 wenn das Team nicht gespeichert werden kann.

GETBeispielteams finden/api/samples/:tier

Ruft die Smogon-Beispielteams für ein Format ab. Die Ergebnisse bleiben eine Stunde im Cache.

Beispiel:

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

Antwort:

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

Antwort: 400 wenn :tier andere Zeichen als Buchstaben oder Ziffern enthält. Wenn es keine Beispielteams für das Format gibt, ist das Array leer.

GETPokémon-Typen abrufen/api/type-chart-data

Ruft die Pokémon-Namen zusammen mit ihrem Typ oder ihren beiden Typen ab. Die Ergebnisse bleiben 24 Stunden im Cache.

Beispiel:

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

Antwort:

[
  ["Bulbasaur", ["Grass", "Poison"]],
  ["Charmander", ["Fire"]]
]
GETAngemeldeten Benutzer abrufen/api/me

Ruft den aktuell bei crob.at angemeldeten Benutzer ab, falls vorhanden. Dieser Endpunkt ist für Oberflächen desselben Ursprungs bestimmt, die die Browsersitzung verwenden.

Beispiel:

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

Antwort:

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

Antwort: {"user": null} wenn keine gültige crob.at-Sitzung aktiv ist.

POSTFeedback senden/api/feedback

Sendet Feedback zum Produkt. Kontaktdaten sind optional. Jede Nachricht darf bis zu 2.000 Zeichen enthalten. Jeder Client kann bis zu fünf Nachrichten pro Stunde senden.

Beispiel:

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

Antwort:

{"success": true}

Antwort: 400 bei einer leeren oder ungültigen Nachricht, 429 bei Erreichen des Anfragelimits und 500 wenn das Feedback nicht gespeichert werden kann.

POSTBei Showdown im Browser anmelden/api/showdown/assertion

Browserfunktion für denselben Ursprung. Sie setzt eine crob.at-Sitzung voraus, die mit Pokémon Showdown verknüpft ist. Die Antwort enthält HTTP 303 mit dem Header Location und einem leeren Body. Der Browser muss die Showdown-Verifizierung abschließen. Die Antwort enthält keine JSON-Assertion.

Anfrageschema: ShowdownAssertionRequest.

{
  "challstr": "12345|abcdefghijklmnopqrstuvwxyz"
}

Die Challenge muss 1 bis 2.048 Zeichen lang sein und darf keine Zeilenumbrüche enthalten. Antwortstatus: 400 bei einer ungültigen Anfrage, 401 wenn eine Anmeldung mit einem verknüpften Showdown-Konto nötig ist, und 503 wenn Showdown OAuth nicht verfügbar ist. Bots, die nur Teamdaten abrufen, brauchen diesen Endpunkt nicht.

Hinweise zur API

Fehler und erneute Versuche

Prüfe den HTTP-Status, bevor du Felder einer erfolgreichen Antwort ausliest. JSON-Fehler enthalten error und können message und retryAfterenthalten. Beispiel: {"error":"Rate limit exceeded","retryAfter":60}.

  • 400: Korrigiere den JSON-Body, den Teamtext, das Format oder die Abfrage vor dem nächsten Versuch.
  • 404: Das Team oder die Generatordaten sind nicht verfügbar. Listen mit Beispielteams liefern stattdessen 200 mit [].
  • 409: Der Schlüssel zum Speichern eines generierten Teams wurde bereits mit anderen Daten verwendet. Verwende denselben Schlüssel und denselben Body beim erneuten Versuch.
  • 429: Warte die in Retry-After angegebene Anzahl an Sekunden, bevor du es erneut versuchst.
  • 500 oder 502: Begrenze die Zahl der Leseversuche und vergrößere die Abstände. Behalte den generierten Text bei, wenn du das Speichern erneut versuchst.

POST /api/team und POST /api/feedback unterstützen keine Idempotenzschlüssel. Wenn unklar ist, ob eine Anfrage den Server erreicht hat, kann ein erneuter Versuch ein Duplikat erzeugen. Jede Generatoranfrage liefert ein neues Zufallsergebnis.

Zugang und Kosten

Alle dokumentierten API-Operationen sind kostenlos. Öffentliche Endpunkte erfordern weder ein Konto noch einen API-Schlüssel, eine Zahlungsmethode oder ein Abo. Optionale Konto- und Pokémon-Showdown-Funktionen verwenden die crob.at-Browsersitzung.

Anfragelimits
  • POST /api/team: 500 neue Teams pro Stunde und Client
  • POST /api/random-team/:format/save: 30 gespeicherte Zufallsteams pro Stunde und Client
  • POST /api/feedback: 5 Nachrichten pro Stunde und Client
  • Bei Erreichen eines Limits antwortet der Server mit HTTP 429 und sendet Retry-After. Schreibende Endpunkte senden außerdem die zugehörigen Header für X-RateLimit-* .
API-Nutzungsbedingungen

Nutze die API rechtmäßig und so, dass sie crob.at und andere Nutzer nicht beeinträchtigt. Umgehe keine Anfragelimits, suche nicht nach privaten Daten und reiche keine missbräuchlichen oder rechtsverletzenden Inhalte ein. Behaupte nicht, crob.at, Pokémon Showdown, Nintendo, Game Freak oder The Pokémon Company unterstützten deine Integration. Wer ein Team veröffentlicht, trägt die Verantwortung für seine Inhalte. Die API wird nach Verfügbarkeit und ohne zugesichertes Serviceniveau bereitgestellt. Sie kann sich ändern. Wichtige Änderungen am API-Vertrag stehen im OpenAPI-Dokument und im Verlauf des Repositorys. Die Datenschutzerklärung erklärt, wie crob.at Konto- und Anfragedaten verarbeitet.

Sicherheit

Öffentliche Endpunkte sind anonym und erfordern keinen Schlüssel. Endpunkte mit Anmeldung verwenden eine sichere crob.at-Browsersitzung und betreffen nur das angemeldete Konto. Sende ein crob.at-Sitzungscookie niemals an einen anderen Ursprung und füge es nie in Clientcode ein. Melde eine Schwachstelle vertraulich per E-Mail an [email protected] und beschreibe, wie sie sich reproduzieren lässt. Greife nicht auf fremde Daten zu und verändere sie nicht.

Anforderungen und Kompatibilität
  • Teams müssen im Exportformat von Pokémon Showdown vorliegen
  • POST /api/team akzeptiert nur JSON
  • Der Teamtext darf bis zu 500.000 Zeichen pro Anfrage enthalten
  • Ein Export kann ein oder mehrere Teams enthalten
  • /api/team, /api/team/:slug, /api/team/:slug/:teamSlug, /api/random-team/:format, /api/random-team/:format/save, /api/samples/:tier, /api/type-chart-dataund /api/feedback erlauben Anfragen von anderen Ursprüngen
  • /api/me und /api/showdown/assertion sind Endpunkte für die crob.at-Oberfläche und Anmeldung, die eine Browsersitzung verwenden
Schemas und Anleitungen für Agenten

Rufe /openapi.json ab, bevor du einen Client generierst. Das Feld jsonSchemaDialect enthält https://json-schema.org/draft/2020-12/schema. Löse lokale $ref innerhalb desselben Dokuments auf. Die gesamte Datei ist ein OpenAPI-Dokument. Anfrage- und Antwortschemas stehen unter components.schemas.

  • CreateTeamRequest → CreatedTeam: eine Teamsammlung erstellen.
  • Team und TeamInPaste: eine Sammlung oder ein einzelnes Team daraus abrufen.
  • GeneratedTeam: generierter Export, Monat der Nutzungsdaten und HTML zur Darstellung des Teams.
  • SaveGeneratedTeamRequest → CreatedTeam: einen generierten Export speichern.
  • Error: Fehlertext mit den optionalen Feldern message und retryAfter.

Das Schema kennzeichnet Pflichtfelder. Manche Antwortfelder können nullsein. Erlaube zusätzliche Antwortfelder. JSON-Schemas beschreiben die Datenstruktur. Der Server prüft außerdem, ob der Text als Pokémon-Team lesbar ist, ob die Formate unterstützt werden und ob die gesamte Textlänge innerhalb des Limits liegt.

Weitere Dokumentationsdateien: Konto- und Zugangsanforderungen, APIs.jsonund API-Katalog.