Wambesha

Tài liệu tham khảo API chỉ có bằng tiếng Anh.

Titles{titleRef}seasons

GET/v1/titles/{titleRef}/seasons

Chỉ tính vào hạn mức lượt gọi

The season guide of a series - numbers, names and episode counts. A film answers an empty list. Spends no verification.

Tham số

titleRefstring · trong đường dẫnbắt buộc
A series (sr_) id or UUID; a film answers an empty list.
Thêm
A public id (mv_, sr_, sn_ or ep_) or the catalog UUID.
languagestringkhông bắt buộc
Response language, a supported BCP-47 tag. Default en.
Thêm
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.

Các trường phản hồi

itemsSeason[]
next_cursorstringcó thể null
totalinteger · int64có thể null
How many items the query matches in total, when that is known. Null when it is not known; it is never an estimate.

Tiêu đề phản hồi

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-ID you send is honoured and echoed back, so you can use your own; otherwise we generate one. /v1 error 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-Reset is (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-Reset is.
X-Quota-Grace
true when THIS request fell inside the 10% grace band above a monthly ceiling. A grace request is served and is not billed; treat true as "back off now", not as headroom. Always true or false, 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-ModeChỉ với khóa demo
Sent only on responses to the public demo key. The value interactive asks 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 in X-Demo-Challenge. Requests made with your own key never receive it.

Lỗi

Chi tiết

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.

Dùng thử

Đang tải khóa demo…

curl "https://api.wambesha.com/v1/titles/sr_ZGSKFCDMQ0/seasons" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ví dụ

{
  "items": [
    {
      "id": "sn_SG39QG2VXE",
      "number": 1,
      "name": "Season 1",
      "episode_count": 8,
      "first_air_date": null,
      "last_air_date": null
    }
  ],
  "next_cursor": null,
  "total": 1
}