مرجع API متوفر باللغة الإنجليزية فقط.
Titles{titleRef}images
GET/v1/
Every stored rendition of a title's posters, backdrops, logos and stills, with pixel sizes. Spends no verification.
المعاملات
- titleRefstring · في المسارمطلوب
A public id (
mv_,sr_,sn_,ep_) or the catalog UUID.المزيد
A public id (
mv_,sr_,sn_orep_) or the catalog UUID. - languagestringاختياري
Prefer images in this 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. - kindposter | backdrop | logo | stillاختياريالافتراضي: all kinds
poster,backdrop,logoorstill. Omit for every kind.المزيد
An unrecognised value is a 400 naming the accepted set, never a silently empty list. Case-insensitive; shown here in lowercase.
- widthintegerاختياري
Only renditions exactly this many pixels wide. A width we do not hold answers empty.
المزيد
Return only renditions at exactly this width. Narrowing, not snapping - asking for a width we do not hold answers empty, which is the honest reply.
حقول الاستجابة
- itemsImage[]
- 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.
الأخطاء
التفاصيل
Every stored rendition, narrowest first within a kind.
Never an unrendered original. A row without a processed master contributes nothing rather than falling back to a raw upstream URL of unknown size and unknown longevity.
kind=still on a SERIES or FILM id legitimately returns an empty list - a still belongs to an episode. That is a true answer, not an error.