Wambesha

La référence de l’API n’est disponible qu’en anglais.

Titles{titleRef}images

GET/v1/titles/{titleRef}/images

Quota d'appels uniquement

Every stored rendition of a title's posters, backdrops, logos and stills, with pixel sizes. Spends no verification.

Paramètres

titleRefstring · dans le cheminobligatoire
A public id (mv_, sr_, sn_, ep_) or the catalog UUID.
Plus
A public id (mv_, sr_, sn_ or ep_) or the catalog UUID.
languagestringfacultatif
Prefer images in this language, a supported BCP-47 tag. Default en.
Plus
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 | stillfacultatifpar défaut : all kinds
poster, backdrop, logo or still. Omit for every kind.
Plus
An unrecognised value is a 400 naming the accepted set, never a silently empty list. Case-insensitive; shown here in lowercase.
widthintegerfacultatif
Only renditions exactly this many pixels wide. A width we do not hold answers empty.
Plus
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.

Champs de la réponse

itemsImage[]
next_cursorstringpeut être null
totalinteger · int64peut être null
How many items the query matches in total, when that is known. Null when it is not known; it is never an estimate.

En-têtes de réponse

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-ModeUniquement avec la clé de démonstration
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.

Erreurs

Détails

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.

Essayez-le

Chargement de la clé de démonstration…

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

Exemple

{
  "items": [
    {
      "url": "https://images.example.com/catalog/9c2a98f3-80be-4b59-940e-57ea9006b9d2/title_backdrop/en/v1/w320.webp",
      "width": 320,
      "height": 180,
      "language": "en",
      "kind": "backdrop"
    },
    {
      "url": "https://images.example.com/catalog/9c2a98f3-80be-4b59-940e-57ea9006b9d2/plain_backdrop/default/v1/w320.webp",
      "width": 320,
      "height": 180,
      "language": null,
      "kind": "backdrop"
    }
  ],
  "next_cursor": null,
  "total": 35
}