Перейти к основному содержимому

Работа с породами

Список и поиск информации о породах: породы кошек.

Список всех пород​

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

Поиск пород​

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

Фильтр по группе пород​

Используйте breed_groups или exclude_breed_groups (через запятую, без учёта регистра), чтобы включить или исключить группы. GET /v1/breeds/breed-groups возвращает доступные группы.

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

Получить сведения о породе​

У пород кошек четырёхбуквенные ID, например abys — абиссинская, beng — бенгальская, siam — сиамская.

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

Пример ответа​

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

Локализация и перевод​

Для аккаунтов Startup и Enterprise данные о породах локализуются: название породы даётся на основном языке страны происхождения, а все текстовые поля переводятся.

Используйте параметр запроса lang, чтобы задать язык ответа, например en, de, es, fr или it. Работает на всех эндпоинтах /breeds:

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

Список фактов о породе​

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