# API за аниме с филтри на discover > amodb няма отделен ендпойнт за аниме. Изброявайте аниме през /3/discover/tv или /3/discover/movie с жанр 16 и with_original_language=ja, после стеснете списъка с id на ключовата дума anime от /3/search/keyword. Японският не е обслужван език на интерфейса, но original_name пази японското заглавие. ## Намиране на аниме с жанр 16 и оригинален език ja amodb няма отделен ендпойнт за аниме. Анимето е филтър на `GET /3/discover/tv` и `GET /3/discover/movie`: `with_genres=16` (Animation) плюс `with_original_language=ja`. Добавете id на ключовата дума `anime`, което намирате с `GET /3/search/keyword`, за да останат само заглавията, отбелязани като аниме. Едно честно ограничение: японският не е сред 14-те езика на интерфейса, които amodb обслужва. Заглавията и описанията се връщат на езика, който поискате, или на английски. Японското заглавие остава в `original_name` за сериали и `original_title` за филми. Какво получавате: - Аниме сериали и пълнометражни аниме филми от същите филтри на discover. - Оригинални японски заглавия до локализираните. - Списъци със сезони и епизоди за всеки избран сериал. - Постери и фонови изображения от `https://img.amodb.dev/t/p/{size}/{file}`. ## Какви данни получавате | От какво имате нужда | Извикване или поле | Бележки | | -------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------- | | Аниме сериали | `GET /3/discover/tv` с `with_genres=16` и `with_original_language=ja` | `results` носят `name`, `original_name`, `first_air_date`, `genre_ids` | | Аниме филми | `GET /3/discover/movie` със същите два филтъра | `title`, `original_title`, `release_date` | | Id на ключовата дума anime | `GET /3/search/keyword?query=anime` | Масив `results` с `id` и `name` | | Списък с епизоди | `GET /3/tv/{series_id}/season/{season_number}` | Едно извикване на сезон | | Японско заглавие | `original_name` или `original_title` | Оригинално писмо, както е записано | | Постер | `poster_path` | Добавя се към хоста за изображения, не е нужен ключ | ## Започнете в 3 стъпки 1. Изберете план на страницата с [цените](https://amodb.dev/bg/pricing/). Всички данни са във всеки план, различава се само скоростта: 20, 40 или 120 заявки в минута. 2. Създайте ключ в личния си профил. 3. Намерете id на ключовата дума веднъж, после извикайте discover с него и двата филтъра. ## Пример със заявка Python скриптът намира id на ключовата дума anime, после изброява най-популярните японски анимационни сериали, отбелязани с нея. Извикването с curl под него пропуска ключовата дума и изброява един сезон на излъчване по прозорец от дати. ```bash curl -s "https://api.amodb.dev/3/discover/tv?with_genres=16&with_original_language=ja&first_air_date.gte=2026-10-01&first_air_date.lte=2026-12-31&sort_by=popularity.desc" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```python import os import requests BASE = "https://api.amodb.dev/3" session = requests.Session() session.headers["Authorization"] = f"Bearer {os.environ['AMODB_KEY']}" def get(path, **params): r = session.get(BASE + path, params=params, timeout=10) r.raise_for_status() return r.json() keywords = get("/search/keyword", query="anime")["results"] anime_id = next((k["id"] for k in keywords if k["name"].lower() == "anime"), None) if anime_id is None: raise SystemExit("anime keyword not found") page = get( "/discover/tv", with_genres=16, with_original_language="ja", with_keywords=anime_id, sort_by="popularity.desc", language="en-US", page=1, ) for show in page["results"]: print(show.get("first_air_date"), show["name"], "/", show["original_name"]) ``` Съкратен отговор за Python извикването по-горе: 2 от 19-те резултата на страница 1, с масиви, съкратени до 2 елемента. ```json { "page": 1, "results": [ { "adult": false, "backdrop_path": "/dmptwhmqxcMrCKgyvBlTt18PgDu.jpg", "first_air_date": "2005-04-22", "genre_ids": [ 10759, 16 ], "id": 65733, "name": "Doraemon", "origin_country": [ "JP" ], "original_language": "ja", "original_name": "ドラえもん", "overview": "Robotic cat Doraemon is sent back in time from the 22nd century to protect 10-year-old...", "popularity": 301.2214, "poster_path": "/9ZN1P32SHviL3SV51qLivxycvcx.jpg", "vote_average": 8.089, "vote_count": 252 }, { "adult": false, "backdrop_path": "/mFKys64gbDQrFqwUheGwXQwo2JK.jpg", "first_air_date": "2004-10-05", "genre_ids": [ 10759, 16 ], "id": 30984, "name": "Bleach", "origin_country": [ "JP" ], "original_language": "ja", "original_name": "BLEACH", "overview": "For as long as he can remember, Ichigo Kurosaki has been able to see ghosts. But when h...", "popularity": 190.3257, "poster_path": "/2EewmxXe72ogD0EaWM8gqa0ccIw.jpg", "vote_average": 8.4, "vote_count": 2295 } ], "total_pages": 216, "total_results": 4302 } ``` ## Филтри, които оформят списък с аниме | Филтър | Стойност | Ефект | | ------------------------------------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animation. Запетаята означава И, така че `16,35` е анимация и комедия. | | `without_genres` | id на жанр | Премахва заглавия с този жанр. | | `with_original_language` | `ja` | Само японски оригинали. | | `with_keywords` | id на ключова дума | Само заглавия, отбелязани с ключовата дума. Заглавия без етикета се пропускат. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Прозорец на излъчване за сериали. Филмите ползват `primary_release_date.gte` и `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Ред. Комбинирайте `vote_average.desc` с `vote_count.gte`, за да не излизат първи малки извадки. | | `page` | от 1 до 500 | До 20 резултата на страница. | Етикетирането с ключови думи е частично. Ако списъкът изглежда кратък, махнете `with_keywords` и оставете филтрите за жанр и език за по-широк обхват. Пълният списък с филтри е на страницата [откриване по филтри](https://amodb.dev/bg/discover/), а id на ключови думи са обяснени на страницата [ключови думи](https://amodb.dev/bg/keywords/). ## Аниме филми и дълги сериали Филмите ползват същите два филтъра на ендпойнта за филми. Това извикване изброява добре оценени японски анимационни филми, а `vote_count.gte` отстранява заглавия с шепа гласове. ```bash curl -s "https://api.amodb.dev/3/discover/movie?with_genres=16&with_original_language=ja&sort_by=vote_average.desc&vote_count.gte=200" \ -H "Authorization: Bearer $AMODB_KEY" ``` Всеки резултат има `title`, `original_title`, `release_date` и `poster_path`. Дългогодишните сериали в каталога често са разделени на няколко сезона. `GET /3/tv/{series_id}/episode_groups` изброява други подредби с имената им и броя епизоди, където са известни, но amodb не обслужва самите групи, а `number_of_episodes` на сериала дава общия брой. Извикванията за сезони са описани на страницата [API за сериали](https://amodb.dev/bg/tv-show-api/). ## Заглавия и езици Анимето е случаят, в който оригиналното заглавие значи най-много, затова пазете и двете полета. | Поле | Какво съдържа | Приложение | | ------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------- | | `name` | Заглавие на езика, който сте поискали | Основен етикет във вашия интерфейс | | `original_name` | Заглавие на оригиналния език, японско писмо за японски оригинали | Втори етикет, полезен за фенове, които знаят японското заглавие | | `original_language` | `ja` | Филтрирайте при себе си, ако смесвате източници | | `overview` | Локализиран текст, празен, когато няма превод | Повторете заявката с `language=en-US`, когато е празен | `GET /3/tv/{series_id}/alternative_titles` изброява други заглавия по държави, където са известни. 14-те обслужвани езика са изброени на страницата [езици](https://amodb.dev/bg/languages/). ## Как се сравнява | Възможност | Обработка на фен сайтове | API на база данни само за аниме | amodb | | ---------------------------- | ------------------------ | ----------------------------------------------- | ---------------------------------------------------------- | | Обхват | Каквото покрива сайтът | Само аниме, за дълбочината вижте документацията | Филми и сериали в един каталог, анимето се избира с филтри | | Избор на аниме | Категории на сайта | Вижте документацията | Жанр 16, `with_original_language=ja`, ключова дума anime | | Заглавие на оригиналния език | Различно | Вижте документацията | `original_name` и `original_title` | | Списъци с епизоди | Разчитани от страници | Вижте документацията | Извикване за сезон с масив `episodes` | | Японски език на интерфейса | Зависи от сайта | Вижте документацията | Не се обслужва, само оригинални заглавия | | Условия за достъп | Условията на всеки сайт | Безплатните и платените планове са различни | Платен, предплатен, без безплатен план | ## Цени Списък с аниме са няколко извиквания на discover, а резултатите от discover остават в edge кеша 30 минути, така че 20 заявки в минута стигат за много приложения. Плановете са за 20, 40 или 120 заявки в минута със същите данни. Плащате за 1, 3, 6, 12 или 24 месеца с отстъпка 0, 10, 20, 30 и 40 процента и без автоматично подновяване. Няма безплатен план. Изберете план на страницата с [цените](https://amodb.dev/bg/pricing/). ## Въпроси и отговори ### Има ли amodb отделен ендпойнт за аниме? Не. Анимето е филтър на обикновените ендпойнти на discover: with_genres=16 за Animation и with_original_language=ja за японски оригинали. Добавете id на ключовата дума anime за по-прецизен списък. ### Мога ли да получа японски заглавия и описания? Японските оригинали запазват японското си заглавие в original_name за сериали и original_title за филми. Японският не е един от 14-те обслужвани езика на интерфейса, затова name и overview следват вашия езиков таг или английски. ### Как да намеря id на ключовата дума anime? Извикайте /3/search/keyword?query=anime и прочетете id на резултата с име anime. Подайте го като with_keywords на discover. Запазете id след първото търсене, защото търсенията на ключови думи се кешират само за 10 минути. ### Връща ли жанр 16 само аниме? Не. Жанр 16 е Animation, който покрива и анимации от други държави. Добавянето на with_original_language=ja премахва повечето от тях, а ключовата дума anime стеснява списъка още. ### Колко дълбоко мога да прелиствам списък с аниме? Страниците са от 1 до 500 с до 20 резултата всяка, така че една заявка стига до около 10 000 резултата. По-големите списъци разбийте на прозорци first_air_date.gte и first_air_date.lte. Резултатите от discover се кешират за 30 минути. ## Свързани страници - [Discover API](https://amodb.dev/bg/discover/): Discover API със същите филтри като TMDB v3. Списък с филми и сериали по жанр, актьори, компания, ключова дума, година, рейтинг и продължителност със сортиране. - [API за ключови думи](https://amodb.dev/bg/keywords/): API за ключови думи с пътища на TMDB v3: тагове на сюжета, търсене на ключова дума, филмите ѝ и комбиниране на id с with_keywords в discover. - [Жанрове и справочни списъци](https://amodb.dev/bg/genres/): API за списък с жанрове с пътища на TMDB v3: id на жанрове за филми и сериали с преведени имена, списъци с държави, езици, длъжности, рейтинги и доставчици. - [Езици](https://amodb.dev/bg/languages/): amodb връща заглавия, описания и имена на 14 езика. Подайте таг в стил TMDB, например ru-RU или pt-BR, в language; всеки друг таг се заменя с английски. - [API за сериали, сезони и епизоди](https://amodb.dev/bg/tv-show-api/): API за сериали със статус, мрежи, сезони, епизоди и next_episode_to_air. JSON, съвместим с TMDB v3, на 14 езика, от 20 заявки в минута на ключ. - [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути. Обновено: 2026-10-18. Source: https://amodb.dev/bg/anime-api/