Saltar al contenido principal

Trabajando con Razas

Lista y busca información de razas de gatos.

Listar todas las razas​

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

Buscar razas​

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

Filtrar por grupo de raza​

Usa breed_groups o exclude_breed_groups (separados por comas, sin distinguir mayúsculas) para incluir o excluir grupos. GET /v1/breeds/breed-groups devuelve los grupos disponibles.

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

Obtener detalles de una raza​

Las razas de gatos tienen IDs de cuatro letras, por ejemplo abys es el Abisinio, beng el Bengalí y siam el Siamés.

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

Respuesta de ejemplo​

{
  "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
}

Localización y Traducción​

Para cuentas Startup y Enterprise, los datos de raza se localizan: el nombre de la raza de gato se da en el idioma principal de su país de origen y todos los campos de texto se traducen.

Usa el parámetro de consulta lang para establecer el idioma de la respuesta, por ejemplo en, de, es, fr o it. Funciona en todos los endpoints /breeds:

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

Listar datos sobre una raza​

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