# API сериалов

> Эндпоинт сериала возвращает один сериал по id через GET /3/tv/{series_id}: названия, описание, статус, сезоны, телесети, жанры и указатели на последнюю и следующую серии. JSON совпадает с TMDB v3, поэтому существующим клиентам нужен лишь новый базовый URL. Добавьте append_to_response, чтобы получить возрастные рейтинги, актеров и рейтинги в одном запросе.

## Эндпоинт

`GET /3/tv/{series_id}`

```bash
curl "https://api.amodb.dev/3/tv/1396?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

Ответ:

```json
{
  "adult": false,
  "backdrop_path": "/ycFcYYnzVc8mWw41neszGPMyKc3.jpg",
  "created_by": [],
  "episode_run_time": [
    48,
    49
  ],
  "first_air_date": "2008-01-20",
  "genres": [
    {
      "id": 18,
      "name": "Drama"
    },
    {
      "id": 80,
      "name": "Crime"
    }
  ],
  "homepage": "",
  "id": 1396,
  "in_production": false,
  "languages": [
    "en"
  ],
  "last_air_date": "2013-09-29",
  "last_episode_to_air": {
    "air_date": "2013-09-29",
    "episode_number": 16,
    "episode_type": "standard",
    "id": 62161,
    "name": "פלינה",
    "overview": "הסדרה זוכת הפרסים מגיעה לסיום דרמתי בפרק החותם אותה.",
    "production_code": "",
    "runtime": 56,
    "season_number": 5,
    "show_id": 1396,
    "still_path": "/pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  "name": "Breaking Bad",
  "next_episode_to_air": null,
  "networks": [
    {
      "id": 174,
      "logo_path": "/pmvRmATOCaDykE6JrVoeYxlFHw3.png",
      "name": "AMC",
      "origin_country": "US"
    }
  ],
  "number_of_episodes": 62,
  "number_of_seasons": 5,
  "origin_country": [
    "US"
  ],
  "original_language": "en",
  "original_name": "Breaking Bad",
  "overview": "Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial...",
  "popularity": 268.4968,
  "poster_path": "/anFx9aTOOYqgS3v7x3R84Kz67ly.jpg",
  "production_companies": [
    {
      "id": 2605,
      "logo_path": null,
      "name": "Gran Via Productions",
      "origin_country": "US"
    },
    {
      "id": 11073,
      "logo_path": "/wHs44fktdoj6c378ZbSWfzKsM2Z.png",
      "name": "Sony Pictures Television",
      "origin_country": "US"
    },
    {
      "id": 33742,
      "logo_path": "/2jdh2sEa0R6y6uT0F7g0IgA2WO8.png",
      "name": "High Bridge Productions",
      "origin_country": "US"
    }
  ],
  "production_countries": [
    {
      "iso_3166_1": "US",
      "name": "United States of America"
    }
  ],
  "seasons": [
    {
      "air_date": "2009-02-17",
      "episode_count": 9,
      "id": 3577,
      "name": "特别篇",
      "overview": "",
      "poster_path": "/ikBSCmgG5Z4jequUUAjKpf1QG3T.jpg",
      "season_number": 0,
      "vote_average": 0
    },
    {
      "air_date": "2008-01-20",
      "episode_count": 7,
      "id": 3572,
      "name": "Season 1",
      "overview": "High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Street-savvy former student Jesse Pinkman \"teaches\" Walter a new trade.",
      "poster_path": "/91EIXdWxmp2mHNRsSuDW3WyDJLj.jpg",
      "season_number": 1,
      "vote_average": 0
    },
    {
      "air_date": "2009-03-08",
      "episode_count": 13,
      "id": 3573,
      "name": "第 2 季",
      "overview": "贩卖冰毒的沃尔特老师在毒品交易中越陷越深，这引起了竞争对手的注意并使他在缉毒局的小舅子陷入危险中。",
      "poster_path": "/zMO024gJxKhTJfWqM0XTYd3SgKj.jpg",
      "season_number": 2,
      "vote_average": 0
    }
  ],
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    },
    {
      "english_name": "Spanish",
      "iso_639_1": "es",
      "name": "Español"
    }
  ],
  "status": "Ended",
  "tagline": "Change the equation.",
  "vote_average": 8.955,
  "vote_count": 18873
}
```

## Детали сериала

`GET /3/tv/{series_id}` возвращает основную запись одного сериала: названия, описание, статус, жанры, телесети, список сезонов и указатели на последнюю и следующую серии. Id это числовой tv id из TMDB, поэтому сериал, который вы храните как `1396`, сохраняет тот же id и здесь. Id фильмов и id сериалов относятся к разным пространствам, поэтому всегда храните тип медиа рядом с числом.

Пример запрашивает Breaking Bad на английском и добавляет возрастные рейтинги и внешние оценки в том же вызове.

```bash
curl -sSf "https://api.amodb.dev/3/tv/1396?language=en-US&append_to_response=content_ratings,ratings" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const params = new URLSearchParams({ language: 'en-US', append_to_response: 'content_ratings,ratings' });
const res = await fetch(`https://api.amodb.dev/3/tv/1396?${params}`, {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb returned ${res.status}`);
const show = await res.json();
const us = show.content_ratings.results.find((r) => r.iso_3166_1 === 'US');
console.log(show.name, show.status, show.number_of_seasons, us?.rating);
```

```python
import os
import requests

r = requests.get(
    "https://api.amodb.dev/3/tv/1396",
    params={"language": "en-US", "append_to_response": "content_ratings,ratings"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
r.raise_for_status()
show = r.json()
us = next((x for x in show["content_ratings"]["results"] if x["iso_3166_1"] == "US"), None)
print(show["name"], show["status"], show["number_of_seasons"], us and us["rating"])
```

```php
<?php
$url = 'https://api.amodb.dev/3/tv/1396?' . http_build_query([
    'language' => 'en-US',
    'append_to_response' => 'content_ratings,ratings',
]);
$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");
}
$show = json_decode($body, true);
echo $show['name'], ' ', $show['status'], ' ', $show['number_of_seasons'], PHP_EOL;
```

```go
package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"os"
	"time"
)

type Show struct {
	Name             string `json:"name"`
	Status           string `json:"status"`
	NumberOfSeasons  int    `json:"number_of_seasons"`
	NumberOfEpisodes int    `json:"number_of_episodes"`
	Next             *struct {
		AirDate string `json:"air_date"`
	} `json:"next_episode_to_air"`
}

func main() {
	q := url.Values{"language": {"en-US"}}
	req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/tv/1396?"+q.Encode(), 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 s Show
	if err := json.NewDecoder(res.Body).Decode(&s); err != nil {
		panic(err)
	}
	next := "none scheduled"
	if s.Next != nil {
		next = s.Next.AirDate
	}
	fmt.Println(s.Name, s.Status, s.NumberOfSeasons, s.NumberOfEpisodes, next)
}
```

### Параметры

| Параметр             | Где   | Обязателен   | Описание                                                                                                |
| -------------------- | ----- | ------------ | ------------------------------------------------------------------------------------------------------- |
| `series_id`          | путь  | да           | Числовой id сериала, например `1396`.                                                                   |
| `api_key`            | query | одно из двух | Ваш ключ. Используйте его или заголовок `Authorization: Bearer`.                                        |
| `language`           | query | нет          | Тег TMDB, например `en-US`, `uk-UA` или `es-ES`. Обслуживаются 14 базовых языков. По умолчанию `en-US`. |
| `append_to_response` | query | нет          | Список подресурсов через запятую, которые нужно добавить в ответ, до 20 значений.                       |

### Поля ответа

| Поле                                               | Тип                 | Примечания                                                                                                                              |
| -------------------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                               | целое число         | Id сериала.                                                                                                                             |
| `name`, `original_name`                            | строка              | Локализованное и оригинальное название. Оригинальные названия на японском или корейском остаются в `original_name`.                     |
| `overview`, `tagline`                              | строка              | Локализованный текст, пуст, если перевода нет.                                                                                          |
| `first_air_date`, `last_air_date`                  | строка или null     | `YYYY-MM-DD`.                                                                                                                           |
| `status`                                           | строка              | Жизненный цикл, см. таблицу ниже.                                                                                                       |
| `in_production`                                    | логическое значение | `true`, пока сериал еще снимается.                                                                                                      |
| `number_of_seasons`, `number_of_episodes`          | целое число         | Итоги, как они хранятся для сериала.                                                                                                    |
| `episode_run_time`                                 | массив              | Типичная длительность серий в минутах, может быть пустым.                                                                               |
| `seasons`                                          | массив              | Одно краткое описание на сезон с `id`, `season_number`, `name`, `overview`, `episode_count`, `air_date`, `poster_path`, `vote_average`. |
| `last_episode_to_air`, `next_episode_to_air`       | объект или null     | Краткие описания серий, по форме совпадают с объектами в разделе [сезоны и серии](https://amodb.dev/ru/tv-seasons-episodes/).           |
| `networks`, `production_companies`                 | массив              | `id`, `name`, `logo_path`, `origin_country`.                                                                                            |
| `production_countries`, `spoken_languages`         | массив              | Страны с `iso_3166_1` и `name`. Языки с `english_name`, `iso_639_1` и `name`.                                                           |
| `created_by`                                       | массив              | Создатели с `id`, `name`, `profile_path` и `credit_id`. У большинства сериалов пуст.                                                    |
| `genres`                                           | массив              | Объекты с `id` и `name`. Id жанров сериалов отличаются от id жанров фильмов.                                                            |
| `origin_country`, `original_language`, `languages` | массив, строка      | Коды стран и коды языков.                                                                                                               |
| `homepage`                                         | строка              | Официальный сайт, пуст, если неизвестен.                                                                                                |
| `poster_path`, `backdrop_path`                     | строка или null     | Добавляйте к `https://img.amodb.dev/t/p/{size}`. См. [API изображений](https://amodb.dev/ru/images-api/).                               |
| `popularity`                                       | число               | Относительная оценка, используемая списком популярных.                                                                                  |
| `vote_average`, `vote_count`                       | число, целое число  | Суммарная пользовательская оценка.                                                                                                      |
| `adult`                                            | логическое значение | Всегда `false`. Материалы для взрослых не отдаются.                                                                                     |

### Пример ответа

`GET /3/tv/1396?language=en-US&append_to_response=content_ratings,ratings`, длинные массивы и тексты сокращены:

```json
{
  "adult": false,
  "backdrop_path": "/ycFcYYnzVc8mWw41neszGPMyKc3.jpg",
  "created_by": [],
  "episode_run_time": [
    48,
    49
  ],
  "first_air_date": "2008-01-20",
  "genres": [
    {
      "id": 18,
      "name": "Drama"
    },
    {
      "id": 80,
      "name": "Crime"
    }
  ],
  "homepage": "",
  "id": 1396,
  "in_production": false,
  "languages": [
    "en"
  ],
  "last_air_date": "2013-09-29",
  "last_episode_to_air": {
    "air_date": "2013-09-29",
    "episode_number": 16,
    "episode_type": "standard",
    "id": 62161,
    "name": "פלינה",
    "overview": "הסדרה זוכת הפרסים מגיעה לסיום דרמתי בפרק החותם אותה.",
    "production_code": "",
    "runtime": 56,
    "season_number": 5,
    "show_id": 1396,
    "still_path": "/pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  "name": "Breaking Bad",
  "next_episode_to_air": null,
  "networks": [
    {
      "id": 174,
      "logo_path": "/pmvRmATOCaDykE6JrVoeYxlFHw3.png",
      "name": "AMC",
      "origin_country": "US"
    }
  ],
  "number_of_episodes": 62,
  "number_of_seasons": 5,
  "origin_country": [
    "US"
  ],
  "original_language": "en",
  "original_name": "Breaking Bad",
  "overview": "Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of o...",
  "popularity": 268.4968,
  "poster_path": "/anFx9aTOOYqgS3v7x3R84Kz67ly.jpg",
  "production_companies": [
    {
      "id": 2605,
      "logo_path": null,
      "name": "Gran Via Productions",
      "origin_country": "US"
    },
    {
      "id": 11073,
      "logo_path": "/wHs44fktdoj6c378ZbSWfzKsM2Z.png",
      "name": "Sony Pictures Television",
      "origin_country": "US"
    }
  ],
  "production_countries": [
    {
      "iso_3166_1": "US",
      "name": "United States of America"
    }
  ],
  "seasons": [
    {
      "air_date": "2009-02-17",
      "episode_count": 9,
      "id": 3577,
      "name": "特别篇",
      "overview": "",
      "poster_path": "/ikBSCmgG5Z4jequUUAjKpf1QG3T.jpg",
      "season_number": 0,
      "vote_average": 0
    },
    {
      "air_date": "2008-01-20",
      "episode_count": 7,
      "id": 3572,
      "name": "Season 1",
      "overview": "High school chemistry teacher Walter White's life is suddenly transformed by a dire medical diagnosis. Stre...",
      "poster_path": "/91EIXdWxmp2mHNRsSuDW3WyDJLj.jpg",
      "season_number": 1,
      "vote_average": 0
    }
  ],
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    },
    {
      "english_name": "Spanish",
      "iso_639_1": "es",
      "name": "Español"
    }
  ],
  "status": "Ended",
  "tagline": "Change the equation.",
  "vote_average": 9,
  "vote_count": 18863,
  "content_ratings": {
    "results": [
      {
        "descriptors": [],
        "iso_3166_1": "AT",
        "rating": "16"
      },
      {
        "descriptors": [],
        "iso_3166_1": "AU",
        "rating": "MA 15+"
      }
    ]
  },
  "ratings": {
    "imdb": {
      "value": 9.5,
      "votes": 2671962
    },
    "kinopoisk": {
      "value": 8.9,
      "votes": null
    },
    "metacritic": null,
    "rotten_tomatoes": {
      "value": 96,
      "votes": null
    },
    "tmdb": {
      "value": 9,
      "votes": 18863
    }
  }
}
```

Блоки `content_ratings` и `ratings` приходят из `append_to_response`. Названия и описания внутри `seasons`, `last_episode_to_air` и `next_episode_to_air` хранятся для каждой записи отдельно и могут не следовать `language`, как показывает название серии на иврите выше. Локализованные тексты сезонов и серий читайте в разделе [сезоны и серии](https://amodb.dev/ru/tv-seasons-episodes/).

## Статус и указатели на серии

`status` показывает, на каком этапе жизни находится сериал, а `next_episode_to_air` подсказывает, когда проверить снова.

| Значение `status`          | Смысл                                 | `next_episode_to_air`                  |
| -------------------------- | ------------------------------------- | -------------------------------------- |
| `Returning Series`         | Выходит сейчас или между сезонами.    | Задан, если дата известна, иначе null. |
| `Planned`, `In Production` | Еще не регулярный сериал.             | Обычно null.                           |
| `Ended`                    | Завершил выход.                       | Null.                                  |
| `Canceled`                 | Остановлен до запланированного конца. | Null.                                  |

У продолжающегося сериала между сезонами `next_episode_to_air` равен null, поэтому читайте null как «дата неизвестна», а не как «завершен».

Массив `seasons` содержит одно краткое описание на сезон, а сезон `0` содержит спецвыпуски. Чтобы прочитать серии сезона, вызовите эндпоинт из раздела [сезоны и серии](https://amodb.dev/ru/tv-seasons-episodes/).

## Связанные эндпоинты сериалов

У всех путей общая база `https://api.amodb.dev/3`, а эндпоинты с локализованным текстом принимают также `language`.

| Метод и путь                             | Что возвращает                                                       | Дополнительные параметры |
| ---------------------------------------- | -------------------------------------------------------------------- | ------------------------ |
| `GET /tv/{series_id}/alternative_titles` | `{id, results}` с `iso_3166_1`, `title`, `type`, часто пусто         | нет                      |
| `GET /tv/{series_id}/content_ratings`    | Возрастной рейтинг по странам                                        | нет                      |
| `GET /tv/{series_id}/episode_groups`     | Список альтернативных порядков серий, например DVD или сюжетные арки | нет                      |
| `GET /tv/{series_id}/recommendations`    | Список из 20 рекомендуемых сериалов                                  | нет                      |
| `GET /tv/{series_id}/similar`            | Список из 20 похожих сериалов                                        | нет                      |
| `GET /tv/{series_id}/reviews`            | `results` пуст у большинства сериалов                                | нет                      |
| `GET /tv/{series_id}/lists`              | Публичные списки, содержащие сериал                                  | `page`                   |
| `GET /tv/{series_id}/watch/providers`    | Сервисы стриминга, аренды и покупки по странам                       | нет                      |
| `GET /tv/latest`                         | Новейшая добавленная запись сериала                                  | нет                      |

Списки рекомендаций и похожих всегда возвращают страницу 1 с 20 элементами. Ответ `lists` постраничный с параметром `page`, по 20 списков на страницу. Постраничные списки в других местах API принимают `page` от 1 до 500.

Возрастные рейтинги приходят записями `results` с `iso_3166_1`, `rating` и `descriptors`, поэтому выбирайте запись для страны зрителя. Сервисы просмотра сгруппированы по коду страны, и в каждой стране есть `link` плюс списки `flatrate`, `rent` и `buy` с `provider_id`, `provider_name`, `logo_path` и `display_priority`. Id сервисов для фильтрации берутся из справочных списков на странице [жанры и справочные списки](https://amodb.dev/ru/genres/).

Список групп серий возвращает `id` (строку), `name`, `description`, `type`, `episode_count`, `group_count` и `network`. amodb перечисляет группы, но не предоставляет эндпоинт, который возвращает серии одной группы. Он также не предоставляет пути `changes` из TMDB.

## Больше данных в одном вызове

Перечислите подресурсы в `append_to_response`, и каждый придет под своим ключом. Весь вызов засчитывается один раз в ваши 20, 40 или 120 запросов в минуту. Работает до 20 значений, неизвестные имена игнорируются без ошибки. Для сериала доступны такие значения:

| Значение                                                                                                                       | Что добавляет                                     | Подробнее                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `credits`                                                                                                                      | Актерский состав и съемочная группа               | [Актеры и съемочная группа](https://amodb.dev/ru/credits/)                                                                                                                       |
| `external_ids`                                                                                                                 | Id, например `imdb_id`, `tvdb_id` и `wikidata_id` | [Поиск по внешнему ID](https://amodb.dev/ru/find-by-external-id/)                                                                                                                |
| `images`, `videos`                                                                                                             | Постеры, фоны (backdrop), трейлеры                | [API изображений](https://amodb.dev/ru/images-api/), [Видео и трейлеры](https://amodb.dev/ru/videos-trailers/)                                                                   |
| `keywords`, `translations`                                                                                                     | Теги и переведенные тексты                        | [Ключевые слова](https://amodb.dev/ru/keywords/), [Переводы](https://amodb.dev/ru/translations/)                                                                                 |
| `content_ratings`, `alternative_titles`, `episode_groups`, `lists`, `watch/providers`, `similar`, `recommendations`, `reviews` | Подресурсы из таблицы выше                        | Эта страница                                                                                                                                                                     |
| `ratings`, `moods`, `soundtracks`, `wikidata`, `showtimes`                                                                     | Дополнения amodb                                  | [Рейтинги](https://amodb.dev/ru/ratings/), [Настроения](https://amodb.dev/ru/moods/), [Саундтреки](https://amodb.dev/ru/soundtracks/), [Сеансы](https://amodb.dev/ru/showtimes/) |

## Ошибки

Неудачный вызов возвращает тело ошибки TMDB. Неверный id дает `status_code` 34 с сообщением «The resource you requested could not be found.»

| HTTP | status_code | Когда                                                                       |
| ---- | ----------- | --------------------------------------------------------------------------- |
| 401  | 7           | Ключ отсутствует или неверен.                                               |
| 402  | 36          | Срок действия тарифа истек.                                                 |
| 404  | 34          | Нет сериала с таким id, материал для взрослых или путь не предоставляется.  |
| 405  | 37          | Вы вызвали метод записи, например оценку сериала.                           |
| 429  | 25          | Превышено число запросов в минуту. Подождите число секунд из `Retry-After`. |

Полный список на странице [ошибки](https://amodb.dev/ru/errors/), лимиты по тарифам на странице [лимиты запросов](https://amodb.dev/ru/rate-limits/).

## Практические заметки

- Детали сериала и все перечисленные выше подресурсы кэшируются на 6 часов. Опрашивайте `last_episode_to_air` не чаще нескольких раз в день.
- Запрашивайте язык, который показываете. Пустой `overview` означает, что перевода нет, поэтому повторите запрос с `en-US` как запасной вариант.
- Используйте `number_of_seasons` как границу цикла, когда загружаете все сезоны по одному вызову на сезон.
- Чтобы получить список сериалов, а не читать один, смотрите [поиск](https://amodb.dev/ru/search/), [discover](https://amodb.dev/ru/discover/) и [списки трендов](https://amodb.dev/ru/trending-lists/).

## Вопросы и ответы

### Как понять, выходит ли сериал сейчас?

Читайте status вместе с next_episode_to_air. У продолжающегося сериала с непустым next_episode_to_air серия запланирована. У завершенных и отмененных сериалов там всегда null, а у сериала между сезонами он тоже может быть.

### Есть ли в записи сериала IMDb id?

В базовой записи нет, как и в TMDB. Добавьте append_to_response=external_ids, чтобы получить imdb_id и tvdb_id, или вызовите эндпоинт find с IMDb id, чтобы перейти от внешнего ID к id сериала.

### Можно ли получить оценки IMDb и Rotten Tomatoes для сериала?

Да. Вызовите GET /3/tv/{series_id}/ratings или добавьте append_to_response=ratings. Вы получите оценки IMDb, Kinopoisk, Metacritic, Rotten Tomatoes и TMDB, каждую как value и votes, или null, если оценка неизвестна.

### Как долго кэшируются данные сериалов?

Детали сериала и их подресурсы кэшируются на CDN на 6 часов, поэтому только что вышедшая серия может появиться в last_episode_to_air с такой задержкой. Списки вроде on the air кэшируются на 30 минут.

## Связанные страницы

- [API сезонов и серий сериала](https://amodb.dev/ru/tv-seasons-episodes/): API сезонов и серий сериала с теми же путями и JSON, что в TMDB v3. Читайте сезон со всеми сериями или одну серию с датой выхода, длительностью и кадром.
- [API актеров и съемочной группы](https://amodb.dev/ru/credits/): API credits с теми же путями и JSON, что в TMDB v3. Актерский состав и съемочная группа фильмов, сериалов, сезонов и серий с полями order, department, job.
- [Рейтинги фильмов и сериалов](https://amodb.dev/ru/ratings/): API рейтингов фильмов: оценки IMDb, Kinopoisk, Metacritic, Rotten Tomatoes и TMDB для тайтла одним запросом, с null для источника, о котором нет данных.
- [API сериалов: сериалы, сезоны и серии](https://amodb.dev/ru/tv-show-api/): API сериалов со статусом, телесетями, сезонами, сериями и полем next_episode_to_air. JSON формата TMDB v3 на 14 языках, тарифы от 20 запросов в минуту.
- [Ошибки](https://amodb.dev/ru/errors/): Все ошибки amodb: HTTP-статус, status_code и сообщение TMDB, а также формат ошибки OMDb. Что означает каждая и что должен делать ваш клиент дальше.
- [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут.

Обновлено: 2026-10-18. Source: https://amodb.dev/ru/tv-series/