# Anime API s filtry discover > amodb nemá samostatný endpoint pro anime. Anime vypíšete přes /3/discover/tv nebo /3/discover/movie se žánrem 16 a with_original_language=ja a pak seznam zúžíte pomocí ID klíčového slova anime z /3/search/keyword. Japonština sice není podporovaný jazyk rozhraní, ale original_name uchovává původní japonský název titulu. ## Najděte anime přes žánr 16 a původní jazyk ja amodb nemá samostatný endpoint pro anime. Anime je filtr na `GET /3/discover/tv` a `GET /3/discover/movie`: `with_genres=16` (animace) plus `with_original_language=ja`. Přidejte ID klíčového slova `anime`, které zjistíte přes `GET /3/search/keyword`, aby zůstaly jen tituly označené jako anime. Jedno poctivé omezení: japonština není jedním ze 14 jazyků rozhraní, které amodb podporuje. Názvy a popisy se vrátí v jazyce, o který požádáte, nebo anglicky. Japonský název zůstává v `original_name` u seriálů a v `original_title` u filmů. Co dostanete: - Anime seriály i anime filmy ze stejných filtrů discover. - Původní japonské názvy vedle lokalizovaných. - Seznamy sezón a epizod pro každý vybraný seriál. - Plakáty a pozadí z `https://img.amodb.dev/t/p/{size}/{file}`. ## Jaká data dostanete | Co potřebujete | Volání nebo pole | Poznámky | | ------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------- | | Anime seriály | `GET /3/discover/tv` s `with_genres=16` a `with_original_language=ja` | `results` obsahují `name`, `original_name`, `first_air_date`, `genre_ids` | | Anime filmy | `GET /3/discover/movie` se stejnými dvěma filtry | `title`, `original_title`, `release_date` | | ID klíčového slova anime | `GET /3/search/keyword?query=anime` | pole `results` s `id` a `name` | | Seznam epizod | `GET /3/tv/{series_id}/season/{season_number}` | Jedno volání na sezónu | | Japonský název | `original_name` nebo `original_title` | Původní písmo, tak jak je uloženo | | Plakát | `poster_path` | Připojte k hostiteli obrázků, klíč není potřeba | ## Začněte ve 3 krocích 1. Vyberte tarif na stránce [ceník](https://amodb.dev/cs/pricing/). Všechna data jsou v každém tarifu, liší se jen rychlost: 20, 40 nebo 120 požadavků za minutu. 2. Vytvořte klíč v panelu účtu. 3. ID klíčového slova zjistěte jednou, pak zavolejte discover s ním a se dvěma filtry. ## Příklad požadavku Skript v Pythonu najde ID klíčového slova anime a pak vypíše nejpopulárnější japonské animované seriály s ním označené. Volání curl pod ním klíčové slovo vynechá a vypíše jednu vysílací sezónu podle okna dat. ```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"]) ``` Zkrácená odpověď na volání v Pythonu výše: 2 z 19 výsledků na stránce 1, pole zkrácená na 2 položky. ```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 } ``` ## Filtry, které tvarují seznam anime | Filtr | Hodnota | Účinek | | ------------------------------------------ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animace. Čárka znamená AND, takže `16,35` je animace a komedie. | | `without_genres` | ID žánru | Vyřadí tituly s tímto žánrem. | | `with_original_language` | `ja` | Jen japonské originály. | | `with_keywords` | ID klíčového slova | Jen tituly označené klíčovým slovem. Tituly bez značky se vynechají. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Vysílací okno pro seriály. Filmy používají `primary_release_date.gte` a `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Řazení. `vote_average.desc` spárujte s `vote_count.gte`, aby na prvních místech nebyly tituly s minimem hlasů. | | `page` | 1 až 500 | Až 20 výsledků na stránku. | Značkování klíčovými slovy je neúplné. Pokud je seznam krátký, vynechte `with_keywords` a ponechte filtry žánru a jazyka pro širší záběr. Úplný seznam filtrů je na stránce [discover](https://amodb.dev/cs/discover/) a ID klíčových slov vysvětluje stránka [klíčová slova](https://amodb.dev/cs/keywords/). ## Anime filmy a dlouhé seriály Filmy používají stejné dva filtry na endpointu pro filmy. Toto volání vypíše dobře hodnocené japonské animované filmy a `vote_count.gte` vyřadí tituly s hrstkou hlasů. ```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" ``` Každý výsledek má `title`, `original_title`, `release_date` a `poster_path`. Dlouho vysílané seriály jsou v katalogu často rozdělené na několik sezón. `GET /3/tv/{series_id}/episode_groups` uvádí jiná řazení s názvy a počty epizod tam, kde jsou známé, ale amodb samotné skupiny neposkytuje a celkový počet udává `number_of_episodes` u seriálu. Volání sezón jsou popsána na stránce [API pro seriály](https://amodb.dev/cs/tv-show-api/). ## Názvy a jazyky Anime je případ, kdy na původním názvu záleží nejvíc, proto ponechte obě pole. | Pole | Obsahuje | Použití | | ------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------- | | `name` | Název v jazyce, o který jste požádali | Hlavní popisek v rozhraní | | `original_name` | Název v původním jazyce, u japonských originálů japonským písmem | Vedlejší popisek, užitečný pro fanoušky, kteří japonský název znají | | `original_language` | `ja` | Filtrujte u sebe, pokud kombinujete zdroje | | `overview` | Lokalizovaný text, prázdný, když překlad neexistuje | Při prázdné hodnotě požádejte znovu s `language=en-US` | `GET /3/tv/{series_id}/alternative_titles` uvádí další názvy podle zemí, kde jsou známé. Všech 14 podporovaných jazyků je uvedeno na stránce [jazyky](https://amodb.dev/cs/languages/). ## Jak si stojí v porovnání | Schopnost | Scrapování fanouškovských webů | Databázové API jen pro anime | amodb | | ----------------------- | ------------------------------ | --------------------------------------- | --------------------------------------------------------- | | Rozsah | Co daný web pokrývá | Jen anime, hloubku ověřte v dokumentaci | Filmy a seriály v jednom katalogu, anime vybrané filtry | | Výběr anime | Kategorie webu | Podívejte se do dokumentace | Žánr 16, `with_original_language=ja`, klíčové slovo anime | | Název v původním jazyce | Různé | Podívejte se do dokumentace | `original_name` a `original_title` | | Seznamy epizod | Parsované ze stránek | Podívejte se do dokumentace | Volání sezóny s polem `episodes` | | Japonský jazyk rozhraní | Záleží na webu | Podívejte se do dokumentace | Není podporován, jen původní názvy | | Podmínky přístupu | Podmínky každého webu | Bezplatné a placené tarify se liší | Placený, předplacený, bez bezplatného tarifu | ## Ceník Seznam anime je pár volání discover a výsledky discover zůstávají v cache na edge 30 minut, takže 20 požadavků za minutu stačí mnoha aplikacím. Tarify mají 20, 40 nebo 120 požadavků za minutu se stejnými daty. Platíte za 1, 3, 6, 12 nebo 24 měsíců se slevou 0, 10, 20, 30 a 40 procent a bez automatického obnovení. Bezplatný tarif neexistuje. Vyberte tarif na stránce [ceník](https://amodb.dev/cs/pricing/). ## Otázky a odpovědi ### Má amodb vyhrazený endpoint pro anime? Ne. Anime je filtr na běžných endpointech discover: with_genres=16 pro animaci a with_original_language=ja pro japonské originály. Pro užší seznam přidejte ID klíčového slova anime. ### Mohu získat japonské názvy a popisy? Japonské originály mají japonský název v original_name u seriálů a v original_title u filmů. Japonština není jedním ze 14 podporovaných jazyků rozhraní, takže name a overview se řídí vaším jazykovým tagem nebo angličtinou. ### Jak zjistím ID klíčového slova anime? Zavolejte /3/search/keyword?query=anime a přečtěte id výsledku pojmenovaného anime. Předejte je jako with_keywords do discover. ID si uložte po prvním vyhledání, protože vyhledávání klíčových slov se cachuje jen 10 minut. ### Vrací žánr 16 jen anime? Ne. Žánr 16 je animace, která zahrnuje i kreslené filmy z jiných zemí. Přidání with_original_language=ja většinu z nich odstraní a klíčové slovo anime seznam zúží dál. ### Jak hluboko lze stránkovat seznam anime? Stránky jsou od 1 do 500 po nejvýše 20 výsledcích, takže jeden dotaz dosáhne asi 10 000 výsledků. Větší seznamy rozdělte na okna first_air_date.gte a first_air_date.lte. Výsledky discover se cachují 30 minut. ## Související stránky - [Discover API](https://amodb.dev/cs/discover/): Discover API se stejnými filtry jako TMDB v3. Vypisujte filmy a seriály podle žánru, společnosti, klíčového slova, roku, hodnocení, délky a poskytovatele. - [API klíčových slov](https://amodb.dev/cs/keywords/): API klíčových slov s cestami TMDB v3: dějové štítky filmu nebo seriálu, detail klíčového slova, jeho filmy a kombinace ID s with_keywords v discover. - [Žánry a číselníky](https://amodb.dev/cs/genres/): Seznam žánrů API s cestami TMDB v3: ID žánrů filmů a seriálů s přeloženými názvy a také číselníky zemí, jazyků, profesí, věkových hodnocení a poskytovatelů. - [Jazyky](https://amodb.dev/cs/languages/): amodb vrací názvy, popisy a jména ve 14 jazycích. Do language předejte tag ve stylu TMDB, např. ru-RU nebo pt-BR; jakýkoli jiný tag použije angličtinu. - [API seriálů pro seriály, sezóny a epizody](https://amodb.dev/cs/tv-show-api/): API seriálů se stavem, televizními sítěmi, sezónami, epizodami a next_episode_to_air. JSON kompatibilní s TMDB v3 ve 14 jazycích, od 20 požadavků za minutu. - [Rychlý start](https://amodb.dev/cs/quickstart/): První volání amodb: získejte klíč, vyžádejte detail filmu v curl, JavaScriptu, Pythonu, PHP nebo Go a načtěte plakát z img.amodb.dev. Za méně než 2 minuty. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/anime-api/