Pular para o conteúdo principal

Trabalhando com Raças

Liste e pesquise informações de raças de gatos.

Listar todas as raças​

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

Pesquisar raças​

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 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.thecatapi.com/v1/breeds?breed_groups=Short-haired,Rex"

Obter detalhes da raça​

As raças de gatos têm IDs de quatro letras, por exemplo abys é o Abissínio, beng o Bengal e siam o Siamês.

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

Exemplo de resposta​

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

Localização e Tradução​

Para contas Startup e Enterprise, os dados de raça são localizados: o nome da raça de gato é 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.thecatapi.com/v1/breeds?lang=de
https://api.thecatapi.com/v1/breeds/beng?lang=de

Listar fatos sobre uma raça​

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