# API anime z filtrami discover > amodb nie ma osobnego endpointu dla anime. Anime wypiszesz przez /3/discover/tv lub /3/discover/movie z gatunkiem 16 i with_original_language=ja, a potem zawęzisz listę, używając ID słowa kluczowego anime z /3/search/keyword. Japoński nie jest obsługiwanym językiem interfejsu, ale original_name zachowuje oryginalny japoński tytuł. ## Znajdź anime przez gatunek 16 i język oryginału ja amodb nie ma osobnego endpointu dla anime. Anime to filtr na `GET /3/discover/tv` i `GET /3/discover/movie`: `with_genres=16` (animacja) plus `with_original_language=ja`. Dodaj ID słowa kluczowego `anime`, które sprawdzisz przez `GET /3/search/keyword`, aby zostały tylko tytuły oznaczone jako anime. Jedno uczciwe ograniczenie: japoński nie należy do 14 języków interfejsu, które obsługuje amodb. Tytuły i opisy wracają w języku, o który prosisz, albo po angielsku. Japoński tytuł zostaje w `original_name` dla seriali i w `original_title` dla filmów. Co dostajesz: - Seriale anime i filmy anime z tych samych filtrów discover. - Oryginalne japońskie tytuły obok zlokalizowanych. - Listy sezonów i odcinków dla każdego wybranego serialu. - Plakaty i tła z `https://img.amodb.dev/t/p/{size}/{file}`. ## Jakie dane dostajesz | Czego potrzebujesz | Wywołanie lub pole | Uwagi | | ------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------- | | Seriale anime | `GET /3/discover/tv` z `with_genres=16` i `with_original_language=ja` | `results` zawierają `name`, `original_name`, `first_air_date`, `genre_ids` | | Filmy anime | `GET /3/discover/movie` z tymi samymi dwoma filtrami | `title`, `original_title`, `release_date` | | ID słowa kluczowego anime | `GET /3/search/keyword?query=anime` | tablica `results` z `id` i `name` | | Lista odcinków | `GET /3/tv/{series_id}/season/{season_number}` | Jedno wywołanie na sezon | | Japoński tytuł | `original_name` lub `original_title` | Oryginalne pismo, tak jak zapisano | | Plakat | `poster_path` | Dołącz do hosta obrazów, klucz niepotrzebny | ## Start w 3 krokach 1. Wybierz plan na stronie [cennik](https://amodb.dev/pl/pricing/). Wszystkie dane są w każdym planie, różni się tylko tempo: 20, 40 lub 120 żądań na minutę. 2. Utwórz klucz w panelu konta. 3. Sprawdź ID słowa kluczowego raz, potem wywołaj discover z nim i z dwoma filtrami. ## Przykładowe żądanie Skrypt w Pythonie znajduje ID słowa kluczowego anime, a potem wypisuje najpopularniejsze japońskie seriale animowane z tym oznaczeniem. Wywołanie curl pod nim pomija słowo kluczowe i wypisuje jeden sezon emisji według 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"]) ``` Przycięta odpowiedź na wywołanie w Pythonie powyżej: 2 z 19 wyników na stronie 1, tablice przycięte do 2 pozycji. ```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 kształtujące listę anime | Filtr | Wartość | Efekt | | ------------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animacja. Przecinek oznacza AND, więc `16,35` to animacja i komedia. | | `without_genres` | ID gatunku | Odrzuca tytuły z tym gatunkiem. | | `with_original_language` | `ja` | Tylko japońskie oryginały. | | `with_keywords` | ID słowa kluczowego | Tylko tytuły oznaczone tym słowem kluczowym. Tytuły bez oznaczenia są pomijane. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Okno emisji dla seriali. Filmy używają `primary_release_date.gte` i `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Kolejność. `vote_average.desc` łącz z `vote_count.gte`, aby małe próbki nie lądowały na szczycie. | | `page` | 1 do 500 | Do 20 wyników na stronę. | Oznaczanie słowami kluczowymi jest częściowe. Jeśli lista wygląda na krótką, usuń `with_keywords` i zostaw filtry gatunku i języka, by zarzucić szerszą sieć. Pełna lista filtrów jest na stronie [discover](https://amodb.dev/pl/discover/), a ID słów kluczowych wyjaśnia strona [słowa kluczowe](https://amodb.dev/pl/keywords/). ## Filmy anime i długie seriale Filmy używają tych samych dwóch filtrów na endpoincie filmów. To wywołanie wypisuje dobrze oceniane japońskie filmy animowane, a `vote_count.gte` odsiewa tytuły z garstką głosów. ```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żdy wynik ma `title`, `original_title`, `release_date` i `poster_path`. Długo emitowane seriale są w katalogu często podzielone na kilka sezonów. `GET /3/tv/{series_id}/episode_groups` wymienia inne układy z nazwami i liczbą odcinków tam, gdzie są znane, ale amodb nie udostępnia samych grup, a łączną liczbę podaje `number_of_episodes` w serialu. Wywołania sezonów opisuje strona [API seriali](https://amodb.dev/pl/tv-show-api/). ## Tytuły i języki Anime to przypadek, w którym oryginalny tytuł liczy się najbardziej, więc zachowaj oba pola. | Pole | Zawiera | Zastosowanie | | ------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------- | | `name` | Tytuł w języku, o który prosisz | Główna etykieta w interfejsie | | `original_name` | Tytuł w języku oryginału, w przypadku japońskich oryginałów japońskim pismem | Etykieta pomocnicza, przydatna dla fanów znających japoński tytuł | | `original_language` | `ja` | Filtruj po swojej stronie, jeśli łączysz źródła | | `overview` | Zlokalizowany tekst, pusty, gdy tłumaczenie nie istnieje | Gdy pusty, poproś ponownie z `language=en-US` | `GET /3/tv/{series_id}/alternative_titles` wymienia inne tytuły według krajów, gdzie są znane. 14 obsługiwanych języków jest wymienionych na stronie [języki](https://amodb.dev/pl/languages/). ## Jak wypada w porównaniu | Możliwość | Scraping stron fanowskich | Baza tylko z anime przez API | amodb | | ------------------------- | ------------------------- | --------------------------------------------- | ------------------------------------------------------------- | | Zakres | Cokolwiek obejmuje strona | Tylko anime, głębokość sprawdź w dokumentacji | Filmy i seriale w jednym katalogu, anime wybierane filtrami | | Wybór anime | Kategorie strony | Sprawdź dokumentację | Gatunek 16, `with_original_language=ja`, słowo kluczowe anime | | Tytuł w języku oryginału | Różnie | Sprawdź dokumentację | `original_name` i `original_title` | | Listy odcinków | Parsowane ze stron | Sprawdź dokumentację | Wywołanie sezonu z tablicą `episodes` | | Japoński język interfejsu | Zależy od strony | Sprawdź dokumentację | Nieobsługiwany, tylko tytuły oryginalne | | Warunki dostępu | Regulamin każdej strony | Plany darmowe i płatne bywają różne | Płatny, przedpłacony, bez darmowego planu | ## Cennik Lista anime to kilka wywołań discover, a wyniki discover zostają w cache na edge przez 30 minut, więc 20 żądań na minutę wystarcza wielu aplikacjom. Plany mają 20, 40 lub 120 żądań na minutę z tymi samymi danymi. Płacisz za 1, 3, 6, 12 lub 24 miesiące ze zniżką 0, 10, 20, 30 i 40 procent, bez automatycznego odnawiania. Nie ma darmowego planu. Wybierz plan na stronie [cennik](https://amodb.dev/pl/pricing/). ## Pytania i odpowiedzi ### Czy amodb ma dedykowany endpoint dla anime? Nie. Anime to filtr na zwykłych endpointach discover: with_genres=16 dla animacji i with_original_language=ja dla japońskich oryginałów. Dodaj ID słowa kluczowego anime, aby zawęzić listę. ### Czy mogę dostać japońskie tytuły i opisy? Japońskie oryginały zachowują japoński tytuł w original_name dla seriali i w original_title dla filmów. Japoński nie należy do 14 obsługiwanych języków interfejsu, więc name i overview zależą od twojego tagu języka albo angielskiego. ### Jak znaleźć ID słowa kluczowego anime? Wywołaj /3/search/keyword?query=anime i odczytaj id wyniku o nazwie anime. Przekaż je jako with_keywords w discover. Zapisz ID po pierwszym wyszukaniu, bo wyszukiwania słów kluczowych są w cache tylko przez 10 minut. ### Czy gatunek 16 zwraca tylko anime? Nie. Gatunek 16 to animacja, która obejmuje też kreskówki z innych krajów. Dodanie with_original_language=ja usuwa większość z nich, a słowo kluczowe anime zawęża listę dalej. ### Jak głęboko można przeglądać listę anime stronami? Strony biegną od 1 do 500, po maksymalnie 20 wyników każda, więc jedno zapytanie sięga około 10 000 wyników. Większe listy dziel na okna first_air_date.gte i first_air_date.lte. Wyniki discover są w cache przez 30 minut. ## Powiązane strony - [Discover API](https://amodb.dev/pl/discover/): Discover API z tymi samymi filtrami co TMDB v3. Wypisuj filmy i seriale według gatunku, obsady, firmy, słowa kluczowego, roku, oceny, czasu trwania i dostawcy. - [API słów kluczowych](https://amodb.dev/pl/keywords/): API słów kluczowych ze ścieżkami TMDB v3: tagi fabularne filmu lub serialu, szczegóły słowa kluczowego, jego filmy i łączenie ID z with_keywords w discover. - [Gatunki i słowniki](https://amodb.dev/pl/genres/): Lista gatunków API ze ścieżkami TMDB v3: ID gatunków filmów i seriali z nazwami w 14 językach oraz słowniki krajów, języków, stanowisk i dostawców streamingu. - [Języki](https://amodb.dev/pl/languages/): amodb serwuje tytuły, opisy i nazwy w 14 językach. Podaj tag w stylu TMDB, np. ru-RU lub pt-BR, w language; każdy inny tag wraca do angielskiego. - [API seriali: seriale, sezony i odcinki](https://amodb.dev/pl/tv-show-api/): API seriali ze statusem, sieciami telewizyjnymi, sezonami, odcinkami i next_episode_to_air. JSON zgodny z TMDB v3 w 14 językach, od 20 żądań na minutę. - [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut. Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/anime-api/