# Trendy i listy > Endpointy trendów i list zwracają uporządkowane strony filmów, seriali lub osób. Użyj GET /3/trending/{media_type}/{time_window} dla wykresów dziennych i tygodniowych oraz ścieżek list movie i tv dla tytułów popularnych, najwyżej ocenianych, granych teraz, nadchodzących, emitowanych dziś i trwających w emisji. Każda strona ma 20 wyników i jest w cache przez 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" ``` Odpowiedź: ```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 } ``` ## Pobieranie trendujących tytułów `GET /3/trending/{media_type}/{time_window}` zwraca uporządkowaną stronę tego, co ludzie właśnie oglądają lub wyszukują. `media_type` to `all`, `movie`, `tv` lub `person`. `time_window` to `day` lub `week`. Wykresy dzienne zmieniają się szybko i pasują do paska „dziś wieczorem”. Wykresy tygodniowe są stabilniejsze i pasują do strony głównej. Przykład prosi o tygodniowy wykres filmów i wypisuje pierwszych dziesięć tytułów. ```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 | Gdzie | Wymagany | Opis | | ------------- | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------- | | `media_type` | path | tak | `all`, `movie`, `tv` lub `person`. | | `time_window` | path | tak | `day` lub `week`. | | `api_key` | query | jeden z dwóch | Twój klucz. Użyj go albo nagłówka `Authorization: Bearer`. | | `language` | query | nie | Tag TMDB, na przykład `en-US` lub `ru-RU`. Obsługiwanych jest 14 języków bazowych, wszystko inne wraca do angielskiego. | | `page` | query | nie | Numer strony od 1 do 500. Każda strona zawiera 20 wyników. | ### Pola odpowiedzi | Pole | Typ | Uwagi | | --------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `page` | integer | Strona, o którą prosisz. | | `results` | array | Obiekty filmów, seriali lub osób, najlepsza pozycja pierwsza. | | `total_pages`, `total_results` | integer | Sumy paginacji. Wykresy trendów zgłaszają najwyżej 500 stron i 10000 wyników. | | `media_type` | string | `movie`, `tv` lub `person` przy każdej pozycji trendów. Odczytaj je, gdy żądasz `all`. | | `id` | integer | Użyj go ze stronami [filmy](https://amodb.dev/pl/movies/), [seriale](https://amodb.dev/pl/tv-series/) lub [osoby](https://amodb.dev/pl/people/). | | `title`, `original_title` | string | Pozycje filmów. Pozycje seriali używają `name` i `original_name`. | | `release_date`, `first_air_date` | string | `YYYY-MM-DD` dla pozycji filmów i seriali. | | `genre_ids` | array | Numeryczne ID. Nazwy pochodzą ze strony [gatunki](https://amodb.dev/pl/genres/). | | `popularity`, `vote_average`, `vote_count` | number | Dane wejściowe rankingu i zbiorcza ocena użytkowników. | | `poster_path`, `backdrop_path`, `profile_path` | string lub null | Dołącz do `https://img.amodb.dev/t/p/{size}`. | | `name`, `original_name`, `gender`, `known_for_department` | string lub integer | Pozycje osób. `known_for` jest pustą tablicą w pozycjach osób w trendach. | ### Przykładowa odpowiedź ```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 } ``` Odpowiedź pobrano z działającego API i przycięto do 3 z 20 pozycji na stronie 1. Długie ciągi `overview` są skrócone, a rangi i liczby zmieniają się przy każdym odświeżeniu. ## Listy filmów Wykresy filmów mają jeden kształt: tablicę `results` z paginacją z obiektami filmów. `now_playing` i `upcoming` dodają obiekt `dates` z `minimum` i `maximum`, czyli oknem premier, które lista obejmuje. Wszystkie cztery przyjmują `language`, `page` i `region`. | Metoda i ścieżka | Zwraca | | ------------------------ | ----------------------------------------------------------------- | | `GET /movie/now_playing` | Filmy wydane w oknie `dates` wokół dzisiaj plus `dates` | | `GET /movie/popular` | Filmy uporządkowane według bieżącej popularności | | `GET /movie/top_rated` | Filmy uporządkowane według oceny użytkowników | | `GET /movie/upcoming` | Filmy z datą premiery w przyszłości plus `dates` | | `GET /movie/latest` | Jeden obiekt filmu: najnowsza pozycja katalogu. To nie jest lista | Prawdziwy obiekt `dates` wygląda tak: ```json { "dates": { "maximum": "2026-10-21", "minimum": "2026-09-09" } } ``` `region` to kod ISO 3166-1 wielkimi literami, na przykład `DE` lub `GB`. W `now_playing` i `upcoming` zostawia tylko tytuły wydane w tym kraju, więc lista jest małą częścią światowej. Nieznany kod zwraca pustą listę. W `popular` i `top_rated` tylko podmienia `release_date` na datę lokalną i nie zmienia rankingu. Aby zobaczyć, gdzie film jest grany, połącz `now_playing` z [seansami](https://amodb.dev/pl/showtimes/). ## Listy seriali Wykresy seriali zwracają te same pola paginacji. Pozycje zamiast nazw z filmów używają `name`, `original_name`, `first_air_date` i `origin_country`. Wszystkie cztery przyjmują `language` i `page`. | Metoda i ścieżka | Zwraca | Dodatkowe parametry | | ---------------------- | ------------------------------------------------------------------- | ------------------- | | `GET /tv/airing_today` | Seriale z odcinkiem emitowanym dziś | `timezone` | | `GET /tv/on_the_air` | Seriale z odcinkiem emitowanym w nadchodzących dniach | `timezone` | | `GET /tv/popular` | Seriale uporządkowane według bieżącej popularności | brak | | `GET /tv/top_rated` | Seriale uporządkowane według oceny użytkowników | brak | | `GET /tv/latest` | Jeden obiekt serialu: najnowsza pozycja katalogu. To nie jest lista | brak | `timezone` to nazwa IANA, na przykład `Europe/Rome`. Decyduje, który dzień kalendarzowy liczy się jako „dziś”, więc `airing_today` zwraca inny zestaw dla `Asia/Tokyo` niż dla `Pacific/Auckland`. Listy seriali nie mają parametru `region`. ## Listy osób `GET /person/popular` zwraca listę osób z paginacją uporządkowaną według popularności, z `language` i `page`. Każda pozycja ma `id`, `name`, `original_name`, `known_for_department`, `gender`, `profile_path`, `popularity` i tablicę `known_for` z maksymalnie 3 kartami filmów lub seriali, każdą z `media_type`. Osobę otworzysz na stronie [osoby](https://amodb.dev/pl/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 nie udostępnia `person/latest` ani kanałów `changes`. ## Wybór właściwej listy dla ekranu | Ekran | Wywołanie | Odświeżanie | | ------------------------------ | ------------------------------------- | ----------------------- | | Rząd hero na stronie głównej | `/trending/all/week` | Co najwyżej co 30 minut | | Zakładka „W kinach” | `/movie/now_playing` z twoim `region` | Co najwyżej co 30 minut | | Zakładka „Wkrótce w kinach” | `/movie/upcoming` z twoim `region` | Co najwyżej co 30 minut | | Pasek „Dziś wieczorem w TV” | `/tv/airing_today` z `timezone` | Co najwyżej co 30 minut | | Ulubione wszech czasów | `/movie/top_rated` | Wystarczy codziennie | | Osoby, które ludzie wyszukują | `/trending/person/day` | Co najwyżej co 30 minut | | Najpopularniejsze osoby ogółem | `/person/popular` | Co najwyżej co 30 minut | ## Błędy | HTTP | status_code | Kiedy | | ---- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 401 | 7 | Brakuje klucza lub jest błędny. | | 402 | 36 | Okres planu dobiegł końca. | | 404 | 34 | Ścieżka nie istnieje, na przykład literówka w nazwie listy albo `media_type` lub `time_window`, których nie ma na powyższych listach. | | 405 | 37 | Użyto metody zapisu na ścieżce listy. | | 429 | 25 | Przekroczono limit żądań na minutę. Poczekaj tyle sekund, ile podaje `Retry-After`. | | 500 | 11 | `page` powyżej 500. | Pełna tabela jest na stronie [błędy](https://amodb.dev/pl/errors/). Limity według planów są na stronie [limity żądań](https://amodb.dev/pl/rate-limits/). ## Praktyczne uwagi - Edge trzyma w cache listy trending, popular, now playing i on the air przez 30 minut, a każdy klucz współdzieli ten sam wpis. Wystarczy zadanie odświeżające co 30 minut. - Strony biegną od 1 do 500. Listy popularnych zgłaszają `total_results` równe 20001, co jest limitem, a nie prawdziwą liczbą. Za stroną 500 użyj [discover](https://amodb.dev/pl/discover/) z `sort_by` i filtrami, które docierają do tytułów, jakich wykres nigdy nie pokazuje. - Pozycje list zawierają tylko pola potrzebne do karty. Po czas trwania, imdb_id lub obsadę wywołaj [szczegóły filmu](https://amodb.dev/pl/movies/) z `append_to_response`, raz dla każdej karty, którą otwiera użytkownik. - `language` steruje językiem tytułów i opisów. Tytuły bez tłumaczenia wracają w tekście oryginalnym, więc przed renderowaniem karty sprawdź puste ciągi. - Zapisuj `id` z listy, a nie pozycję. Rangi zmieniają się przy każdym odświeżeniu. ## Pytania i odpowiedzi ### Jak długo listy trendów i popularne są w cache? Edge trzyma w cache listy trending, popular, now playing i on the air przez 30 minut i współdzieli każdy wpis między kluczami. Odpytywanie częściej niż co 30 minut zwraca tę samą stronę i bez potrzeby zużywa żądania. ### Ile stron mogę odczytać z listy? Strony biegną od 1 do 500 po 20 wyników, tak samo jak w TMDB. Do głębszego przeglądania użyj discover, które filtruje według gatunku, roku, obsady lub firmy zamiast podążać za jednym stałym wykresem. ### Które listy przyjmują parametr region? now_playing i upcoming przyjmują region jako dwuliterowy kod kraju wielkimi literami, na przykład GB, i zostawiają tylko tytuły wydane tam. popular i top_rated go przyjmują, ale tylko podmieniają release_date na datę lokalną. Listy seriali nie mają region. airing_today i on_the_air używają timezone. ### Czy mogę filtrować wykres według gatunku? Nie na tych ścieżkach. Pozycje list niosą genre_ids do wyświetlania. Aby filtrować według gatunku, użyj discover z with_genres, a ID zamień na nazwy przez endpointy list gatunków. ## Powiązane strony - [API szczegółów filmu](https://amodb.dev/pl/movies/): API szczegółów filmu z tymi samymi ścieżkami i JSON co TMDB v3. Pobierz film po ID, dołącz obsadę, oceny i nastroje przez append_to_response, 14 języków. - [API szczegółów serialu](https://amodb.dev/pl/tv-series/): API szczegółów serialu z tymi samymi ścieżkami i JSON co TMDB v3. Serial po ID z sezonami, sieciami, klasyfikacją wiekową i dostawcami streamingu. - [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. - [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. - [Seanse kinowe](https://amodb.dev/pl/showtimes/): API seansów filmu zwraca kina i godziny seansów w jednym kraju albo podsumowanie krajów. Scal je ze szczegółami przez append_to_response lub z now_playing. - [Limity żądań](https://amodb.dev/pl/rate-limits/): amodb limituje klucz liczbą żądań na minutę w przesuwanym oknie 60 sekund: 20, 40 lub 120 zależnie od planu. Czytaj nagłówki limitu i obsłuż 429 z Retry-After. Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/trending-lists/