Pular para o conteúdo principal

Trabalhando com Raças

Liste e pesquise informações de raças de cães.

Listar todas as raças​

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

Pesquisar raças​

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 raça​

Use breed_groups ou exclude_breed_groups (separados por vírgula, sem distinção de maiúsculas) para incluir ou excluir grupos. GET /v1/breeds/breed-groups retorna os grupos disponíveis.

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/breeds?breed_groups=Toy,Working"

Obter detalhes da raça​

As raças de cães têm IDs numéricos, por exemplo 1 é o Affenpinscher e 115 o Pastor Alemão.

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

Exemplo de resposta​

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

Localização e Tradução​

Para contas Startup e Enterprise, os dados de raça são localizados: o nome da raça de cão é dado no idioma principal do país de origem e todos os campos de texto são traduzidos.

Use o parâmetro de consulta lang para definir o idioma da resposta, por exemplo en, de, es, fr ou it. Funciona em todos os endpoints /breeds:

https://api.thedogapi.com/v1/breeds?lang=de
https://api.thedogapi.com/v1/breeds/1?lang=de

Listar fatos sobre uma raça​

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