Справочник по API доступен только на английском языке.
Titles{titleRef}seasons
GET/v1/
The season guide of a series - numbers, names and episode counts. A film answers an empty list. Spends no verification.
Параметры
- titleRefstring · в путиобязательный
A series (
sr_) id or UUID; a film answers an empty list.Ещё
A public id (
mv_,sr_,sn_orep_) or the catalog UUID. - languagestringнеобязательный
Response language, a supported BCP-47 tag. Default
en.Ещё
A supported BCP-47 tag. Defaults to
en. An UNSUPPORTED tag is a 400 naming the accepted set, never a silent fallback - the catalogue stores match the 17 tags as exact strings, so degrading would answer an empty 200 that an integrator would ship before noticing.
Поля ответа
- itemsSeason[]
- next_cursorstringможет быть null
- totalinteger · int64может быть null
How many items the query matches in total, when that is known. Null when it is not known; it is never an estimate.
Заголовки ответа
- X-Request-ID
The id of this request, on every response - success or error. Quote it to support: it is how we find your request in our logs. An
X-Request-IDyou send is honoured and echoed back, so you can use your own; otherwise we generate one./v1error bodies carry no trace id of their own. - X-Quota-Reset
RFC 3339 instant at which the billing period rolls. Present on every response to a request whose key was metered - every 2xx, every error a handler returned, and the quota 429. Absent on a refusal that happens before metering: a missing or unknown key (401), a restricted key or a plan that does not carry the endpoint (403), a public demo-key gate refusal, and the pre-authentication flood throttle.
- X-Calls-Remaining
Requests left in the period after this one, never below 0. Present whenever
X-Quota-Resetis (see there for when a response carries no quota headers). - X-Verifications-Remaining
How many verifications you can still make before a limit stops you. The daily limit and the monthly allowance are counted separately; this is whichever of the two runs out first. Sent whenever
X-Quota-Resetis. - X-Quota-Grace
truewhen THIS request fell inside the 10% grace band above a monthly ceiling. A grace request is served and is not billed; treattrueas "back off now", not as headroom. Alwaystrueorfalse, never absent when the other quota headers are present. - Retry-After429
Seconds to wait before retrying. On every 429 - the quota hard stop, the public demo key's limits, and the pre-authentication flood throttle (which carries this header alone, because no key has been read yet).
- X-Demo-Challenge-ModeТолько с демо-ключом
Sent only on responses to the public demo key. The value
interactiveasks the documentation page to show the visible verification widget - it is sent once a browser has made more than five runs in ten minutes or has received a 429. The page then repeats the header,X-Demo-Challenge-Mode: interactive, on its next request, with the widget's token inX-Demo-Challenge. Requests made with your own key never receive it.
Ошибки
Подробности
One entry per visible season.
A film id returns an EMPTY ARRAY, not an error. "This record has no seasons" is a true and useful answer, and a 400 would force a generic client to branch on structural kind before it was allowed to ask.
Season 0 (specials) is excluded unconditionally. The include_specials parameter was WITHDRAWN on 2026-09-07 - a deliberate, operator-authorised breaking change to this frozen surface, recorded as D-40. The catalog no longer creates season 0, so the parameter could only have surfaced unplayable rows. A client still sending it receives a 200 with the parameter ignored; nothing here rejects unknown query parameters.