Zum Hauptinhalt springen

Arbeiten mit Rassen

Liste und suche nach Informationen zu Katzenrassen.

Alle Rassen auflisten​

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/breeds

Rassen suchen​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/breeds/search?q=siamese"
🎮 Interactive DemoOpen in new tab ↗

Nach Rassengruppe filtern​

Mit breed_groups oder exclude_breed_groups (kommagetrennt, Groß-/Kleinschreibung egal) kannst du Gruppen ein- oder ausschließen. GET /v1/breeds/breed-groups liefert die verfügbaren Gruppen.

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/breeds?breed_groups=Short-haired,Rex"

Rassendetails abrufen​

Katzenrassen haben vierbuchstabige IDs, z.B. abys für die Abessinier, beng für die Bengal und siam für die Siam.

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/breeds/beng

Beispielantwort​

{
  "id": "abys",
  "name": "Abyssinian",
  "species_id": "1",
  "life_span": "14-17",
  "temperament": "Active, Energetic, Independent, Intelligent, Gentle, Curious, Playful",
  "origin": "Egypt",
  "country_code": "EG",
  "breed_group": "Short-haired",
  "reference_image_id": "KWdLHmOqc",
  "image": {
    "id": "KWdLHmOqc",
    "url": "https://cdn2.thecatapi.com/images/KWdLHmOqc.jpg",
    "width": 3114,
    "height": 2609
  },
  "affection_level": 3,
  "energy_level": 3,
  "vocalisation": 3,
  "hypoallergenic": false
}

Lokalisierung und Übersetzung​

Für Startup- und Enterprise-Konten werden die Rassendaten lokalisiert: Der Name der Katzenrasse wird in der Hauptsprache des Herkunftslandes angegeben, wobei alle Textfelder übersetzt werden.

Verwende den lang Query-Parameter, um die Sprache der Antwort festzulegen, z.B. en, de, es, fr oder it. Das funktioniert bei allen /breeds Endpunkten:

https://api.thecatapi.com/v1/breeds?lang=de
https://api.thecatapi.com/v1/breeds/beng?lang=de

Fakten zu einer Rasse auflisten​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/facts/breed/abys?limit=5"