AniHub API

AniHub API

Публічний HTTP API AniHub для доступу до каталогу аніме, жанрів, персонажів, студій і розкладу виходу епізодів. Усі endpoints нижче є read-only і повертають відповіді в JSON.

Rate limit: 40 запитів на хвилину з одного IP
Базовий URL
https://api.anihub.in.ua
Приклад
GET https://api.anihub.in.ua/anime/4825
Приклад відповіді
{
  "id": 4825,
  "mal_id": null,
  "anilist_id": 152991,
  "slug": "monoloh-travnytsi",
  "title_ukrainian": "Монолог травниці",
  "status": "completed",
  "type": "tv",
  "year": 2023,
  "has_ukrainian_dub": true,
  "episodes_count": 24,
  "imdb_id": "tt26743760",
  "genres": ["Драма", "Детектив", "Історичний", ...]
}

Аніме

Каталог, пошук, картка тайтлу та готові добірки.

GET/anime

Список аніме з фільтрами та пагінацією

Підтримує пошук, сортування та фільтри по статусу, типу, року, сезону. Також можна шукати за зовнішніми ID.

Параметри
pagepage_sizesearchstatustypeyearseason_nameorderinghas_ukrainian_dubmal_idanilist_idimdb_id
Пояснення параметрів
pageНомер сторінки, починаючи з 1.
page_sizeРозмір сторінки. Для public API: від 1 до 20.
searchІндексований пошук по title_ukrainian, title_english, title_original та alias. У PostgreSQL підтримує typo/fuzzy через pg_trgm.
statusСтатус аніме: ongoing, completed, announced, dropped.
typeТип аніме: tv, tv_special, movie, ova, ona, special.
yearТочний рік виходу, наприклад 2024.
season_nameПора року: winter, spring, summer, fall.
orderingСортування: -rating, rating, -site_rating, site_rating, -year, year, -updated_at, updated_at, -library_count, library_count, title_ukrainian, -title_ukrainian.
has_ukrainian_dubФільтр по дубляжу: true або false.
mal_idТочний MyAnimeList ID.
anilist_idТочний AniList ID.
imdb_idТочний IMDb ID.
Відповідь
totalpagepage_sizeitems[]
Структура відповіді
totalЗагальна кількість знайдених записів.
pageПоточна сторінка.
page_sizeПоточний розмір сторінки.
items[]Масив аніме на поточній сторінці. Кожен елемент містить id, slug, назви, status, type, year, дубляж, жанри, студії, скріншоти, рейтинг та зовнішні ID.
GET/anime/{anime_id}

Картка аніме за ID

Повна інформація: назви, жанри, студії озвучення, рейтинг.

Пояснення параметрів
anime_idВнутрішній ID аніме у базі AniHub.
Відповідь
idmal_idanilist_idslugtitlesgenresdubbing_studiosrating
Структура відповіді
idВнутрішній ID аніме.
mal_id / anilist_id / imdb_idЗовнішні ідентифікатори, якщо вони прив'язані.
slugSEO-friendly slug тайтлу.
titlesУкраїнська, оригінальна та англійська назви.
genresСписок жанрів аніме.
dubbing_studiosСписок студій українського озвучення.
ratingПоточний рейтинг тайтлу.
GET/anime/popular

Популярні аніме

Параметри
limit
Пояснення параметрів
limitКількість записів у відповіді.
Структура відповіді
items[]Добірка популярних аніме у скороченому форматі.
GET/anime/recommended

Рекомендовані тайтли

Параметри
limit
Пояснення параметрів
limitКількість записів у відповіді.
Структура відповіді
items[]Добірка рекомендованих тайтлів у скороченому форматі.
GET/anime/seasonal

Аніме поточного сезону

Параметри
limit
Пояснення параметрів
limitКількість записів у відповіді.
Структура відповіді
items[]Добірка сезонних тайтлів у скороченому форматі.
GET/anime/announced

Анонсовані тайтли

Параметри
limit
Пояснення параметрів
limitКількість записів у відповіді.
Структура відповіді
items[]Добірка анонсованих тайтлів у скороченому форматі.
GET/anime/newest

Нещодавно додані

Параметри
limit
Пояснення параметрів
limitКількість записів у відповіді.
Структура відповіді
items[]Останні додані тайтли у скороченому форматі.
GET/anime/random

Випадковий тайтл

Структура відповіді
animeОдин випадковий тайтл у скороченому форматі.

Жанри

Список жанрів та жанрові сторінки.

GET/genres

Усі жанри з кількістю аніме

Відповідь
totalitems[]
Структура відповіді
totalЗагальна кількість жанрів.
items[]Список жанрів із базовими атрибутами та кількістю аніме.
GET/genres/{genre_id}

Жанр з превʼю аніме

Включає top та recent аніме для цього жанру.

Параметри
preview_limitshow_nsfw
Пояснення параметрів
genre_idВнутрішній ID жанру.
preview_limitКількість елементів у блоках top/recent.
show_nsfwЧи включати NSFW контент: true або false.
Відповідь
idsluganime_counttop_anime[]recent_anime[]
Структура відповіді
id / slugІдентифікатор і slug жанру.
anime_countКількість аніме в жанрі.
top_anime[]Підбірка найрейтинговіших тайтлів жанру.
recent_anime[]Підбірка нещодавніх тайтлів жанру.

Персонажі

Пошук та картки персонажів.

GET/characters

Список персонажів із пошуком

Параметри
searchpagepage_size
Пояснення параметрів
searchПошук за іменем персонажа.
pageНомер сторінки, починаючи з 1.
page_sizeРозмір сторінки.
Відповідь
totalpagepage_sizeitems[]
Структура відповіді
totalЗагальна кількість персонажів, що відповідають фільтру.
page / page_sizeПоточна сторінка і її розмір.
items[]Масив персонажів у скороченому форматі.
GET/characters/{character_id}

Картка персонажа за ID

Пояснення параметрів
character_idВнутрішній ID персонажа.
Структура відповіді
characterПовний профіль персонажа з базовими метаданими і прив'язками.

Студії

Озвучення та анімаційні студії.

GET/studios

Студії озвучення

Параметри
pagepage_sizeorderingsearch
Пояснення параметрів
page / page_sizeПараметри пагінації.
orderingПоле сортування списку студій.
searchПошук за назвою студії.
Структура відповіді
total / items[]Пагінований список студій озвучення.
GET/studios/{studio_id}

Картка студії озвучення

Пояснення параметрів
studio_idВнутрішній ID студії озвучення.
Структура відповіді
studioДетальна інформація про студію озвучення.
GET/studios/{studio_id}/anime

Аніме студії озвучення

Параметри
pagepage_size
Пояснення параметрів
studio_idВнутрішній ID студії озвучення.
page / page_sizeПараметри пагінації.
Структура відповіді
total / items[]Пагінований список аніме, де присутня ця студія.
GET/animation-studios

Анімаційні студії

Параметри
pagepage_sizeorderingsearch
Пояснення параметрів
page / page_sizeПараметри пагінації.
orderingПоле сортування списку анімаційних студій.
searchПошук за назвою анімаційної студії.
Структура відповіді
total / items[]Пагінований список анімаційних студій.
GET/animation-studios/{studio_id}

Картка анімаційної студії

Пояснення параметрів
studio_idВнутрішній ID анімаційної студії.
Структура відповіді
studioДетальна інформація про анімаційну студію.
GET/animation-studios/{studio_id}/anime

Аніме анімаційної студії

Параметри
pagepage_size
Пояснення параметрів
studio_idВнутрішній ID анімаційної студії.
page / page_sizeПараметри пагінації.
Структура відповіді
total / items[]Пагінований список аніме, пов'язаних з анімаційною студією.

Розклад

Графік виходу нових епізодів.

GET/airing-schedule

Розклад епізодів

Підтримує grouped (по днях) та flat формат.

Параметри
startendonly_ukrainiangroup_by
Пояснення параметрів
startПочаток діапазону дат.
endКінець діапазону дат.
only_ukrainianЯкщо true, повертає тільки тайтли з has_ukrainian_dub=true.
group_byФормат відповіді: grouped або flat.
Відповідь
results[]windowtotal_days / count
Структура відповіді
results[]Масив записів розкладу або масив груп по днях, залежно від group_by.
windowІнформація про часовий діапазон відповіді.
total_days / countЗведена статистика по кількості днів або записів.