# Trendy a seznamy > Endpointy trendů a seznamů vracejí seřazené stránky filmů, seriálů nebo osob. Použijte GET /3/trending/{media_type}/{time_window} pro denní a týdenní žebříčky a cesty seznamů movie a tv pro populární, nejlépe hodnocené, aktuálně uváděné, připravované, dnes vysílané a právě vysílané tituly. Každá stránka obsahuje 20 výsledků a cachuje se 30 minut. ## Endpoint `GET /3/trending/{media_type}/{time_window}` ```bash curl "https://api.amodb.dev/3/trending/movie/week?language=en-US" \ -H "Authorization: Bearer $AMODB_KEY" ``` Odpověď: ```json { "page": 1, "results": [ { "adult": false, "backdrop_path": "/mBZKC8ActTlM4W3HEGI1Cl1RtO3.jpg", "genre_ids": [ 878, 9648, 28 ], "id": 1058424, "original_language": "ko", "original_title": "호프", "overview": "In the remote South Korean village of Hope Harbor, police chief Bum-seok and officer Sung-ae are called to investigate a mysterious creature wreaking havoc on the community. But all is not as it seems, and perceptions can be misleading. Wha...", "popularity": 368.4952, "poster_path": "/bcK5naYzzfY0JBCgrPrsrbV6NO1.jpg", "release_date": "2026-07-15", "title": "Hope", "video": false, "vote_average": 6.9, "vote_count": 256, "media_type": "movie" }, { "adult": false, "backdrop_path": "/5YfPIIMzGBkIjHt3PTXBWyfBTGS.jpg", "genre_ids": [ 28, 14 ], "id": 1153576, "original_language": "en", "original_title": "Street Fighter", "overview": "In 1993, estranged Street Fighters Ryu and Ken Masters are thrown back into combat when the mysterious Chun-Li recruits them for the next World Warrior Tournament: a brutal clash of fists, fate, and fury. But behind this battle royale lies...", "popularity": 225.4202, "poster_path": "/utKzCSCz2HtXwcDGfWLj2IHhSob.jpg", "release_date": "2026-10-13", "title": "Street Fighter", "video": false, "vote_average": 6.365, "vote_count": 85, "media_type": "movie" }, { "adult": false, "backdrop_path": "/tanwf7KOwQ6dxZzehKsXkffIJOd.jpg", "genre_ids": [ 878, 28, 12 ], "id": 969681, "original_language": "en", "original_title": "Spider-Man: Brand New Day", "overview": "Fighting crime full-time as Spider-Man in a world that doesn't remember him—and the pressure of seeing his old friends move on without him—sparks a change in Peter Parker he may not have the power to control. But that transformation might a...", "popularity": 655.4447, "poster_path": "/bjiS5ipwxb9JFy3XRRN4OAilSeX.jpg", "release_date": "2026-07-29", "title": "Spider-Man: Brand New Day", "video": false, "vote_average": 8.469, "vote_count": 5725, "media_type": "movie" } ], "total_pages": 500, "total_results": 10000 } ``` ## Získání trendujících titulů `GET /3/trending/{media_type}/{time_window}` vrací seřazenou stránku toho, co lidé právě sledují nebo vyhledávají. `media_type` je `all`, `movie`, `tv` nebo `person`. `time_window` je `day` nebo `week`. Denní žebříčky se rychle mění a hodí se na pás „dnes večer“. Týdenní žebříčky jsou stabilnější a hodí se na úvodní stránku. Příklad si vyžádá týdenní žebříček filmů a vypíše prvních deset titulů. ```bash curl -s "https://api.amodb.dev/3/trending/movie/week?language=en-US&page=1" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```js const url = 'https://api.amodb.dev/3/trending/movie/week?language=en-US&page=1'; const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` } }); if (!res.ok) throw new Error(`amodb returned ${res.status}`); const chart = await res.json(); for (const [i, m] of chart.results.slice(0, 10).entries()) { console.log(i + 1, m.title, m.release_date); } ``` ```python import os import requests r = requests.get( "https://api.amodb.dev/3/trending/movie/week", params={"language": "en-US", "page": 1}, headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"}, timeout=10, ) r.raise_for_status() for i, m in enumerate(r.json()["results"][:10], start=1): print(i, m["title"], m.get("release_date")) ``` ```php true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')], ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($status !== 200) { throw new RuntimeException("amodb returned $status"); } $chart = json_decode($body, true); foreach (array_slice($chart['results'], 0, 10) as $i => $m) { echo ($i + 1), ' ', $m['title'], ' ', $m['release_date'] ?? '', PHP_EOL; } ``` ```go package main import ( "encoding/json" "fmt" "net/http" "os" "time" ) type Chart struct { Results []struct { Title string `json:"title"` ReleaseDate string `json:"release_date"` } `json:"results"` } func main() { url := "https://api.amodb.dev/3/trending/movie/week?language=en-US&page=1" req, _ := http.NewRequest("GET", url, nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY")) client := &http.Client{Timeout: 10 * time.Second} res, err := client.Do(req) if err != nil { panic(err) } defer res.Body.Close() if res.StatusCode != http.StatusOK { panic(res.Status) } var chart Chart if err := json.NewDecoder(res.Body).Decode(&chart); err != nil { panic(err) } for i, m := range chart.Results { if i == 10 { break } fmt.Println(i+1, m.Title, m.ReleaseDate) } } ``` ### Parametry | Parametr | Kde | Povinný | Popis | | ------------- | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------- | | `media_type` | path | ano | `all`, `movie`, `tv` nebo `person`. | | `time_window` | path | ano | `day` nebo `week`. | | `api_key` | query | jeden ze dvou | Váš klíč. Použijte jej, nebo hlavičku `Authorization: Bearer`. | | `language` | query | ne | Tag TMDB, například `en-US` nebo `ru-RU`. Podporuje se 14 základních jazyků, cokoli jiného se vrátí k angličtině. | | `page` | query | ne | Číslo stránky od 1 do 500. Každá stránka obsahuje 20 výsledků. | ### Pole odpovědi | Pole | Typ | Poznámky | | --------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | Stránka, o kterou jste požádali. | | `results` | array | Objekty filmů, seriálů nebo osob, nejlepší pořadí první. | | `total_pages`, `total_results` | integer | Součty stránkování. Žebříčky trendů hlásí nejvýše 500 stránek a 10000 výsledků. | | `media_type` | string | `movie`, `tv` nebo `person` u každé položky trendů. Čtěte jej, když požadujete `all`. | | `id` | integer | Použijte jej se stránkami [filmy](https://amodb.dev/cs/movies/), [seriály](https://amodb.dev/cs/tv-series/) nebo [osoby](https://amodb.dev/cs/people/). | | `title`, `original_title` | string | Položky filmů. Položky seriálů používají `name` a `original_name`. | | `release_date`, `first_air_date` | string | `YYYY-MM-DD` pro položky filmů a seriálů. | | `genre_ids` | array | Číselná ID. Názvy jsou na stránce [žánry](https://amodb.dev/cs/genres/). | | `popularity`, `vote_average`, `vote_count` | number | Vstupy pořadí a souhrnné skóre uživatelů. | | `poster_path`, `backdrop_path`, `profile_path` | string nebo null | Připojte k `https://img.amodb.dev/t/p/{size}`. | | `name`, `original_name`, `gender`, `known_for_department` | string nebo integer | Položky osob. `known_for` je u položek osob v trendech prázdné pole. | ### Příklad odpovědi ```json { "page": 1, "results": [ { "adult": false, "backdrop_path": "/7ULXMNvmZSi13zN3EZjz8wbER9B.jpg", "genre_ids": [28, 53], "id": 1561726, "original_language": "en", "original_title": "Masterplan", "overview": "When a legendary thief sets his sights on the Mona Lisa, he recruits two young strangers to help him before...", "popularity": 189.8286, "poster_path": "/3x3AfF0qVwSUDDciTaNKcPHZUN8.jpg", "release_date": "2026-10-16", "title": "Masterplan", "video": false, "vote_average": 7.279, "vote_count": 61, "media_type": "movie" }, { "adult": false, "backdrop_path": "/mBZKC8ActTlM4W3HEGI1Cl1RtO3.jpg", "genre_ids": [878, 9648, 28], "id": 1058424, "original_language": "ko", "original_title": "호프", "overview": "In the remote South Korean village of Hope Harbor, police chief Bum-seok and officer Sung-ae are called to...", "popularity": 294.6518, "poster_path": "/bcK5naYzzfY0JBCgrPrsrbV6NO1.jpg", "release_date": "2026-07-15", "title": "Hope", "video": false, "vote_average": 6.917, "vote_count": 246, "media_type": "movie" }, { "adult": false, "backdrop_path": "/5YfPIIMzGBkIjHt3PTXBWyfBTGS.jpg", "genre_ids": [28, 14], "id": 1153576, "original_language": "en", "original_title": "Street Fighter", "overview": "In 1993, estranged Street Fighters Ryu and Ken Masters are thrown back into combat when the mysterious Chun...", "popularity": 209.3923, "poster_path": "/utKzCSCz2HtXwcDGfWLj2IHhSob.jpg", "release_date": "2026-10-13", "title": "Street Fighter", "video": false, "vote_average": 6.316, "vote_count": 76, "media_type": "movie" } ], "total_pages": 500, "total_results": 10000 } ``` Odpověď byla stažena z živého API a zkrácena na 3 z 20 položek na stránce 1. Dlouhé řetězce `overview` jsou zkráceny a pořadí a počty se mění při každém obnovení. ## Seznamy filmů Žebříčky filmů sdílejí jeden tvar: stránkované pole `results` s objekty filmů. `now_playing` a `upcoming` přidávají objekt `dates` s `minimum` a `maximum`, tedy okno vydání, které seznam pokrývá. Všechny čtyři přijímají `language`, `page` a `region`. | Metoda a cesta | Vrací | | ------------------------ | --------------------------------------------------------------- | | `GET /movie/now_playing` | Filmy vydané v okně `dates` kolem dneška plus `dates` | | `GET /movie/popular` | Filmy řazené podle aktuální popularity | | `GET /movie/top_rated` | Filmy řazené podle skóre uživatelů | | `GET /movie/upcoming` | Filmy s datem vydání v budoucnu plus `dates` | | `GET /movie/latest` | Jeden objekt filmu: nejnovější položka katalogu. Není to seznam | Skutečný objekt `dates` vypadá takto: ```json { "dates": { "maximum": "2026-10-21", "minimum": "2026-09-09" } } ``` `region` je kód ISO 3166-1 velkými písmeny, například `DE` nebo `GB`. U `now_playing` a `upcoming` ponechá jen tituly vydané v dané zemi, takže seznam je malou částí celosvětového. Neznámý kód vrací prázdný seznam. U `popular` a `top_rated` jen vymění `release_date` za místní datum a pořadí nemění. Chcete-li vidět, kde se film promítá, spárujte `now_playing` s [promítacími časy](https://amodb.dev/cs/showtimes/). ## Seznamy seriálů Žebříčky seriálů vracejí stejná pole stránkování. Položky místo názvů z filmů používají `name`, `original_name`, `first_air_date` a `origin_country`. Všechny čtyři přijímají `language` a `page`. | Metoda a cesta | Vrací | Další parametry | | ---------------------- | ----------------------------------------------------------------- | --------------- | | `GET /tv/airing_today` | Seriály s epizodou vysílanou dnes | `timezone` | | `GET /tv/on_the_air` | Seriály s epizodou vysílanou v příštích dnech | `timezone` | | `GET /tv/popular` | Seriály řazené podle aktuální popularity | žádné | | `GET /tv/top_rated` | Seriály řazené podle skóre uživatelů | žádné | | `GET /tv/latest` | Jeden objekt seriálu: nejnovější položka katalogu. Není to seznam | žádné | `timezone` je název IANA, například `Europe/Rome`. Rozhoduje, který kalendářní den se počítá jako „dnes“, takže `airing_today` vrací pro `Asia/Tokyo` jinou sadu než pro `Pacific/Auckland`. Seznamy seriálů parametr `region` nemají. ## Seznamy osob `GET /person/popular` vrací stránkovaný seznam osob řazených podle popularity, s `language` a `page`. Každá položka má `id`, `name`, `original_name`, `known_for_department`, `gender`, `profile_path`, `popularity` a pole `known_for` s až 3 kartami filmů nebo seriálů, každou s `media_type`. Osobu otevřete na stránce [osoby](https://amodb.dev/cs/people/). ```json { "page": 1, "results": [ { "adult": false, "gender": 1, "id": 1247604, "known_for_department": "Acting", "name": "Agnez Mo", "original_name": "Agnez Mo", "popularity": 45.8988, "profile_path": "/7GuBJxf5szQRCKLk3iG2ztfCo39.jpg", "known_for": [ { "adult": false, "backdrop_path": "/pF0qkRsrHkdYadPWY9AMeFZfcwk.jpg", "first_air_date": "2022-02-03", "genre_ids": [10759], "id": 108978, "name": "Reacher", "origin_country": ["US"], "original_language": "en", "original_name": "Reacher", "overview": "Jack Reacher, a veteran military police investigator, has just recently enter...", "popularity": 411.841, "poster_path": "/f1VCQIG2iCyOookdgOzwtUpwWC0.jpg", "vote_average": 8.1, "vote_count": 3508, "media_type": "tv" } ] } ], "total_pages": 1001, "total_results": 20001 } ``` amodb nenabízí `person/latest` ani feedy `changes`. ## Výběr správného seznamu pro obrazovku | Obrazovka | Volání | Obnova | | ----------------------------- | ------------------------------------- | ------------------------ | | Hlavní řada na úvodní stránce | `/trending/all/week` | Nejvýše každých 30 minut | | Záložka „V kinech“ | `/movie/now_playing` s vaším `region` | Nejvýše každých 30 minut | | Záložka „Brzy v kinech“ | `/movie/upcoming` s vaším `region` | Nejvýše každých 30 minut | | Pás „Dnes večer v televizi“ | `/tv/airing_today` s `timezone` | Nejvýše každých 30 minut | | Oblíbené všech dob | `/movie/top_rated` | Stačí denně | | Osoby, které lidé vyhledávají | `/trending/person/day` | Nejvýše každých 30 minut | | Nejpopulárnější osoby celkově | `/person/popular` | Nejvýše každých 30 minut | ## Chyby | HTTP | status_code | Kdy | | ---- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | | 401 | 7 | Klíč chybí nebo je nesprávný. | | 402 | 36 | Platnost tarifu skončila. | | 404 | 34 | Cesta neexistuje, například překlep v názvu seznamu nebo `media_type` či `time_window`, které nejsou ve výše uvedených seznamech. | | 405 | 37 | Použili jste metodu pro zápis na cestě seznamu. | | 429 | 25 | Překročili jste počet požadavků za minutu. Počkejte tolik sekund, kolik říká `Retry-After`. | | 500 | 11 | Hodnota `page` nad 500. | Úplná tabulka je na stránce [chyby](https://amodb.dev/cs/errors/). Limity podle tarifu jsou na stránce [limity požadavků](https://amodb.dev/cs/rate-limits/). ## Praktické poznámky - Edge cachuje seznamy trending, popular, now playing a on the air 30 minut a každý klíč sdílí stejnou položku. Stačí úloha obnovy každých 30 minut. - Stránky jdou od 1 do 500. Seznamy populárních hlásí `total_results` 20001, což je strop, ne skutečný počet. Za stránkou 500 použijte [discover](https://amodb.dev/cs/discover/) s `sort_by` a filtry, které dosáhne na tituly, jež žebříček nikdy neukáže. - Položky seznamů obsahují jen pole potřebná pro kartu. Pro délku, imdb_id nebo obsazení zavolejte [detail filmu](https://amodb.dev/cs/movies/) s `append_to_response`, jednou pro každou kartu, kterou uživatel otevře. - `language` řídí jazyk názvů a popisů. Tituly bez překladu přijdou v původním textu, před vykreslením karty proto zkontrolujte prázdné řetězce. - Ukládejte `id` ze seznamu, ne pozici. Pořadí se mění při každém obnovení. ## Otázky a odpovědi ### Jak dlouho se cachují seznamy trendů a populárních? Edge cachuje seznamy trending, popular, now playing a on the air 30 minut a každou položku sdílí mezi klíči. Dotazování častěji než každých 30 minut vrátí stejnou stránku a zbytečně spotřebuje požadavky. ### Kolik stránek mohu ze seznamu přečíst? Stránky jdou od 1 do 500 po 20 výsledcích, stejné limity jako u TMDB. Pro hlubší procházení použijte discover, které filtruje podle žánru, roku, obsazení nebo společnosti místo sledování jednoho pevného žebříčku. ### Které seznamy přijímají parametr region? now_playing a upcoming přijímají region jako dvoupísmenný kód země velkými písmeny, například GB, a ponechají jen tituly vydané tam. popular a top_rated ho přijímají, ale jen vymění release_date za místní datum. Seznamy seriálů region nemají. airing_today a on_the_air používají timezone. ### Mohu žebříček filtrovat podle žánru? Ne na těchto cestách. Položky seznamů nesou genre_ids pro zobrazení. K filtrování podle žánru použijte discover s with_genres a ID na názvy převeďte přes endpointy seznamů žánrů. ## Související stránky - [API detailu filmu](https://amodb.dev/cs/movies/): API detailu filmu se stejnými cestami a JSON jako TMDB v3. Načtěte film podle ID, přidejte obsazení, hodnocení a nálady přes append_to_response, 14 jazyků. - [API detailu seriálu](https://amodb.dev/cs/tv-series/): API detailu seriálu se stejnými cestami a JSON jako TMDB v3. Seriál podle ID se sezónami, sítěmi, věkovým hodnocením a poskytovateli streamování. - [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. - [Žá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ů. - [Promítací časy v kinech](https://amodb.dev/cs/showtimes/): API promítacích časů filmu vrací kina a časy promítání v jedné zemi nebo souhrn zemí. Sloučte je s detaily přes append_to_response nebo spárujte s now_playing. - [Limity požadavků](https://amodb.dev/cs/rate-limits/): amodb omezuje klíč počtem požadavků za minutu v klouzavém okně 60 sekund: 20, 40 nebo 120 podle tarifu. Čtěte hlavičky limitu a řešte 429 pomocí Retry-After. Aktualizováno: 2026-10-18. Source: https://amodb.dev/cs/trending-lists/