Эндпоінты трэндаў і спісаў

Атрыманне трэндавых назваў

GET /3/trending/{media_type}/{time_window} вяртае ранжыраваную старонку таго, што людзі глядзяць або шукаюць менавіта цяпер. media_type гэта all, movie, tv або person. time_window гэта day або week. Чарты за дзень хутка мяняюцца і пасуюць для стужкі «сёння ўвечары». Чарты за тыдзень стабільнейшыя і пасуюць для галоўнай старонкі.

У прыкладзе запытваецца тыднёвы чарт фільмаў і друкуюцца першыя дзесяць назваў.

curl -s "https://api.amodb.dev/3/trending/movie/week?language=en-US&page=1" \
  -H "Authorization: Bearer $AMODB_KEY"

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);
}

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
$url = 'https://api.amodb.dev/3/trending/movie/week?language=en-US&page=1';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => 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;
}

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

Параметры

• media_typeшляхабавязковы
  all, movie, tv або person.
• time_windowшляхабавязковы
  day або week.
• api_keyзапытадзін з двух
  Ваш ключ. Выкарыстоўвайце яго або загаловак Authorization: Bearer.
• languageзапыт
  Тэг TMDB, напрыклад en-US або ru-RU. Падтрымліваюцца 14 базавых моў, усё астатняе замяняецца англійскай.
• pageзапыт
  Нумар старонкі ад 1 да 500. Кожная старонка змяшчае 20 вынікаў.

Палі адказу

Прыклад адказу

{
  "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
}

Адказ атрыманы з жывога API і скарочаны да 3 з 20 запісаў на старонцы 1. Доўгія радкі overview скарочаны, а рангі і лічбы мяняюцца пры кожным абнаўленні.

Спісы фільмаў

Чарты фільмаў маюць адну форму: масіў results з аб’ектамі фільмаў па старонках. now_playing і upcoming дадаюць аб’ект dates з minimum і maximum, акном выхаду, якое ахоплівае спіс. Усе чатыры прымаюць language, page і region.

Сапраўдны аб’ект dates выглядае так:

{ "dates": { "maximum": "2026-10-21", "minimum": "2026-09-09" } }

region гэта код ISO 3166-1 вялікімі літарамі, напрыклад DE або GB. У now_playing і upcoming ён пакідае толькі назвы, што выйшлі ў гэтай краіне, таму спіс ёсць малой часткай сусветнага. Невядомы код вяртае пусты спіс. У popular і top_rated ён толькі замяняе release_date на мясцовую дату і не змяняе ранжыраванне. Каб убачыць, дзе ідзе фільм, спалучайце now_playing са старонкай сеансы.

Спісы серыялаў

Чарты серыялаў вяртаюць тыя ж палі старонак. Запісы выкарыстоўваюць name, original_name, first_air_date і origin_country замест назваў для фільмаў. Усе чатыры прымаюць language і page.

timezone гэта назва IANA, напрыклад Europe/Rome. Яна вызначае, які каляндарны дзень лічыцца «сёння», таму airing_today вяртае розны набор для Asia/Tokyo і для Pacific/Auckland. У спісаў серыялаў няма параметра region.

Спісы людзей

GET /person/popular вяртае спіс людзей па старонках, ранжыраваных па папулярнасці, з language і page. Кожны запіс мае id, name, original_name, known_for_department, gender, profile_path, popularity і масіў known_for з не болей чым 3 картак фільмаў або серыялаў, кожная з media_type. Адкрыйце персону на старонцы персоны.

{
  "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 не прапануе person/latest і стужкі changes.

Як абраць патрэбны спіс для экрана

Памылкі

Поўная табліца ёсць на старонцы памылкі. Ліміты па планах на старонцы ліміты запытаў.

Практычныя заўвагі

• Edge кэшуе спісы трэндаў, папулярных, now playing і on the air на 30 хвілін, і кожны ключ дзеліць адзін запіс. Задачы абнаўлення, якая запускаецца раз у 30 хвілін, дастаткова.
• Старонкі ідуць ад 1 да 500. У спісах папулярных total_results роўны 20001, гэта абмежаванне, а не рэальная колькасць. Далей за старонку 500 выкарыстоўвайце пошук па фільтрах з sort_by і фільтрамі, які даходзіць да назваў, што чарт ніколі не паказвае.
• Запісы спісаў змяшчаюць толькі палі, патрэбныя для карткі. Для працягласці, imdb_id або ўдзельнікаў выклічце дэталі фільма з append_to_response, адзін раз для кожнай карткі, якую адкрывае карыстальнік.
• language кіруе мовай назваў і апісанняў. Назвы без перакладу вяртаюцца ў арыгінальным тэксце, таму правярайце пустыя радкі, перш чым адлюстроўваць картку.
• Захоўвайце id са спісу, а не месца. Рангі мяняюцца пры кожным абнаўленні.