Zum Hauptinhalt springen

Arbeiten mit Rassen

Liste und suche nach Informationen zu Hunderassen.

Alle Rassen auflisten​

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

Rassen suchen​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/breeds/search?q=terrier"
🎮 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.thedogapi.com/v1/breeds?breed_groups=Toy,Working"

Rassendetails abrufen​

Hunderassen haben numerische IDs, z.B. 1 für den Affenpinscher und 115 für den Deutschen Schäferhund.

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

Beispielantwort​

{
  "id": "1",
  "name": "Affenpinscher",
  "species_id": "2",
  "life_span": "12-15",
  "temperament": "Confident, alert, playful, loyal, courageous",
  "origin": "Germany",
  "country_code": "DE",
  "breed_group": "Toy",
  "reference_image_id": "BJa4kxc4X",
  "image": {
    "id": "BJa4kxc4X",
    "width": 1600,
    "height": 1199,
    "url": "https://cdn2.thedogapi.com/images/BJa4kxc4X.jpg"
  }
}

Lokalisierung und Übersetzung​

Für Startup- und Enterprise-Konten werden die Rassendaten lokalisiert: Der Name der Hunderasse 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.thedogapi.com/v1/breeds?lang=de
https://api.thedogapi.com/v1/breeds/1?lang=de

Fakten zu einer Rasse auflisten​

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