Saltar al contenido principal

Trabajando con Razas

Lista y busca información de razas de perros.

Listar todas las razas​

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

Buscar razas​

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

Obtener detalles de una raza​

Las razas de perros tienen IDs numéricos, por ejemplo 1 es el Affenpinscher y 115 el Pastor Alemán.

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

Respuesta de ejemplo​

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

Localización y Traducción​

Para cuentas Startup y Enterprise, los datos de raza se localizan: el nombre de la raza de perro 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.thedogapi.com/v1/breeds?lang=de
https://api.thedogapi.com/v1/breeds/1?lang=de

Listar datos sobre una raza​

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