# API anime cu filtre discover

> amodb nu are un endpoint separat pentru anime. Listează anime cu /3/discover/tv sau /3/discover/movie folosind genul 16 și with_original_language=ja, apoi restrânge lista cu ID-ul cuvântului-cheie anime din /3/search/keyword. Japoneza nu este o limbă de interfață servită, dar original_name păstrează titlul japonez în scrierea originală.

## Găsește anime cu genul 16 și limba originală ja

amodb nu are un endpoint separat pentru anime. Anime este un filtru pe `GET /3/discover/tv` și `GET /3/discover/movie`: `with_genres=16` (Animație) plus `with_original_language=ja`. Adaugă ID-ul cuvântului-cheie `anime`, pe care îl cauți cu `GET /3/search/keyword`, ca să păstrezi doar titlurile etichetate ca anime.

O limită spusă deschis: japoneza nu este una dintre cele 14 limbi de interfață pe care le servește amodb. Titlurile și descrierile revin în limba pe care o ceri sau în engleză. Titlul japonez rămâne în `original_name` pentru seriale și în `original_title` pentru filme.

Ce primești:

- Seriale anime și filme anime din aceleași filtre discover.
- Titluri originale japoneze alături de cele localizate.
- Liste de sezoane și episoade pentru fiecare serial ales.
- Postere și imagini de fundal de la `https://img.amodb.dev/t/p/{size}/{file}`.

## Ce date primești

| Ai nevoie de                 | Apel sau câmp                                                           | Observații                                                              |
| ---------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Seriale anime                | `GET /3/discover/tv` cu `with_genres=16` și `with_original_language=ja` | `results` conțin `name`, `original_name`, `first_air_date`, `genre_ids` |
| Filme anime                  | `GET /3/discover/movie` cu aceleași două filtre                         | `title`, `original_title`, `release_date`                               |
| ID-ul cuvântului-cheie anime | `GET /3/search/keyword?query=anime`                                     | array-ul `results` cu `id` și `name`                                    |
| Lista de episoade            | `GET /3/tv/{series_id}/season/{season_number}`                          | Un apel pe sezon                                                        |
| Titlul japonez               | `original_name` sau `original_title`                                    | Scrierea originală, așa cum este stocată                                |
| Poster                       | `poster_path`                                                           | Se adaugă la gazda de imagini, fără cheie                               |

## Începe în 3 pași

1. Alege un plan la [prețuri](https://amodb.dev/ro/pricing/). Toate datele sunt în fiecare plan, diferă doar ritmul: 20, 40 sau 120 de cereri pe minut.
2. Creează o cheie în panoul contului tău.
3. Caută o singură dată ID-ul cuvântului-cheie, apoi apelează discover cu el și cu cele două filtre.

## Exemplu de cerere

Scriptul Python găsește ID-ul cuvântului-cheie anime, apoi listează cele mai populare seriale animate japoneze etichetate cu el. Apelul curl de sub el sare peste cuvântul-cheie și listează un singur sezon de difuzare, pe fereastră de date.

```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"])
```

Un răspuns scurtat pentru apelul Python de mai sus: 2 din cele 19 rezultate de pe pagina 1, cu array-urile tăiate la 2 elemente.

```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
}
```

## Filtre care modelează o listă de anime

| Filtru                                     | Valoare                                                       | Efect                                                                                                      |
| ------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `with_genres`                              | `16`                                                          | Animație. O virgulă înseamnă ȘI, deci `16,35` înseamnă animație și comedie.                                |
| `without_genres`                           | ID de gen                                                     | Elimină titlurile care au genul respectiv.                                                                 |
| `with_original_language`                   | `ja`                                                          | Doar producții originale japoneze.                                                                         |
| `with_keywords`                            | ID de cuvânt-cheie                                            | Doar titlurile etichetate cu cuvântul-cheie. Titlurile fără etichetă sunt ratate.                          |
| `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD`                                                  | O fereastră de difuzare pentru seriale. Filmele folosesc `primary_release_date.gte` și `.lte`.             |
| `sort_by`                                  | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Ordinea. Combină `vote_average.desc` cu `vote_count.gte`, ca eșantioanele mici să nu ajungă pe primul loc. |
| `page`                                     | de la 1 la 500                                                | Până la 20 de rezultate pe pagină.                                                                         |

Etichetarea cu cuvinte-cheie este parțială. Dacă o listă pare scurtă, renunță la `with_keywords` și păstrează filtrele de gen și de limbă pentru o plasă mai largă. Lista completă de filtre este la [descoperire](https://amodb.dev/ro/discover/), iar ID-urile cuvintelor-cheie sunt explicate la [cuvinte-cheie](https://amodb.dev/ro/keywords/).

## Filme anime și seriale lungi

Filmele folosesc aceleași două filtre pe endpoint-ul pentru filme. Acest apel listează filme animate japoneze bine cotate, iar `vote_count.gte` exclude titlurile cu doar câteva voturi.

```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"
```

Fiecare rezultat are `title`, `original_title`, `release_date` și `poster_path`. Serialele lungi sunt adesea împărțite în mai multe sezoane în catalog. `GET /3/tv/{series_id}/episode_groups` listează alte ordini cu numele și numărul de episoade, acolo unde sunt cunoscute, dar amodb nu servește grupurile în sine, iar `number_of_episodes` din serial dă totalul. Apelurile pentru sezoane sunt descrise la [API pentru seriale TV](https://amodb.dev/ro/tv-show-api/).

## Titluri și limbi

Anime este cazul în care titlul original contează cel mai mult, așa că păstrează ambele câmpuri.

| Câmp                | Conține                                                                    | Utilizare                                                         |
| ------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `name`              | Titlul în limba pe care ai cerut-o                                         | Eticheta principală în interfața ta                               |
| `original_name`     | Titlul în limba originală, în scriere japoneză pentru producțiile japoneze | Etichetă secundară, utilă pentru fanii care cunosc titlul japonez |
| `original_language` | `ja`                                                                       | Filtrează în aplicația ta dacă amesteci surse                     |
| `overview`          | Text localizat, gol când nu există traducere                               | Cere din nou cu `language=en-US` când este gol                    |

`GET /3/tv/{series_id}/alternative_titles` listează alte titluri pe țări, acolo unde sunt cunoscute. Cele 14 limbi servite sunt listate la [limbi](https://amodb.dev/ro/languages/).

## Cum se compară

| Capacitate                  | Extragi date de pe site-uri de fani | API de bază de date doar pentru anime           | amodb                                                              |
| --------------------------- | ----------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------ |
| Acoperire                   | Ce acoperă site-ul                  | Doar anime, vezi documentația pentru profunzime | Filme și seriale TV într-un singur catalog, anime ales prin filtre |
| Selectarea anime            | Categoriile site-ului               | Vezi documentația                               | Genul 16, `with_original_language=ja`, cuvântul-cheie anime        |
| Titlul în limba originală   | Variază                             | Vezi documentația                               | `original_name` și `original_title`                                |
| Liste de episoade           | Extrase din pagini                  | Vezi documentația                               | Apel pentru sezon cu un array `episodes`                           |
| Limba japoneză de interfață | Depinde de site                     | Vezi documentația                               | Nu este servită, doar titluri originale                            |
| Condiții de acces           | Termenii fiecărui site              | Nivelurile gratuite și cele cu plată variază    | Cu plată, plătit în avans, fără nivel gratuit                      |

## Prețuri

O listă de anime înseamnă câteva apeluri discover, iar rezultatele discover rămân în cache-ul de la margine 30 de minute, așa că 20 de cereri pe minut ajung pentru multe aplicații. Planurile vin cu 20, 40 sau 120 de cereri pe minut, cu aceleași date. Plătești pentru 1, 3, 6, 12 sau 24 de luni, cu reduceri de 0, 10, 20, 30 și 40 la sută și fără reînnoire automată. Nu există nivel gratuit. Alege un plan la [prețuri](https://amodb.dev/ro/pricing/).

## Întrebări și răspunsuri

### Are amodb un endpoint dedicat pentru anime?

Nu. Anime este un filtru pe endpoint-urile discover obișnuite: with_genres=16 pentru Animație și with_original_language=ja pentru producțiile originale japoneze. Adaugă ID-ul cuvântului-cheie anime pentru o listă mai precisă.

### Pot obține titluri și descrieri în japoneză?

Producțiile originale japoneze păstrează titlul japonez în original_name pentru seriale și în original_title pentru filme. Japoneza nu este una dintre cele 14 limbi de interfață servite, așa că name și overview urmează eticheta ta de limbă sau engleza.

### Cum găsesc ID-ul cuvântului-cheie anime?

Apelează /3/search/keyword?query=anime și citește id-ul rezultatului numit anime. Transmite-l ca with_keywords la discover. Păstrează ID-ul după prima căutare, deoarece căutările de cuvinte-cheie sunt ținute în cache doar 10 minute.

### Întoarce genul 16 doar anime?

Nu. Genul 16 este Animație și acoperă și desene animate din alte țări. Cu with_original_language=ja dispar majoritatea, iar cuvântul-cheie anime restrânge lista și mai mult.

### Cât de adânc pot parcurge o listă de anime?

Paginile merg de la 1 la 500, cu până la 20 de rezultate fiecare, deci o interogare ajunge la aproximativ 10,000 de rezultate. Împarte listele mai mari în ferestre first_air_date.gte și first_air_date.lte. Rezultatele discover sunt ținute în cache 30 de minute.

## Pagini conexe

- [API discover](https://amodb.dev/ro/discover/): API discover cu filtrele TMDB v3. Listează filme și seriale după gen, distribuție, companie, cuvânt-cheie, an, evaluare, durată și furnizor, cu sortare.
- [API cuvinte-cheie](https://amodb.dev/ro/keywords/): API cuvinte-cheie cu căi TMDB v3: listează etichetele unui film sau serial, caută un cuvânt-cheie, listează filmele lui și combină ID-urile cu with_keywords.
- [Genuri și liste de referință](https://amodb.dev/ro/genres/): API listă de genuri cu căi TMDB v3: ID-uri de gen pentru filme și TV cu nume traduse, plus liste de țări, limbi, meserii, clasificări și furnizori de vizionare.
- [Limbi](https://amodb.dev/ro/languages/): amodb servește titluri, descrieri și nume în 14 limbi. Trimite în language o etichetă în stil TMDB, precum ru-RU sau pt-BR; altă etichetă revine la engleză.
- [API seriale TV pentru seriale, sezoane și episoade](https://amodb.dev/ro/tv-show-api/): API seriale TV cu starea serialului, rețele, sezoane, episoade și next_episode_to_air. JSON compatibil TMDB v3 în 14 limbi, de la 20 de cereri pe minut.
- [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute.

Actualizat: 2026-10-18. Source: https://amodb.dev/ro/anime-api/
