Wambesha

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

Titles{titleRef}

GET/v1/titles/{titleRef}

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

One title record - film, series, season or episode - by public id or UUID, optionally with credits, images and similar titles inlined. Spends no verification.

Tham số

titleRefstring · trong đường dẫnbắt buộc
A public id (mv_, sr_, sn_, ep_) or the catalog UUID.
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.
appendstringkhông bắt buộc
Comma-separated extras to inline: credits, images, similar.
Thêm
Comma-separated extras to inline - credits, images, similar. Anything not asked for is null, never an empty object.

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

idstring
The public id - mv_, sr_, sn_ or ep_. The identifier every other endpoint accepts.
uuidstring · uuid
The catalog UUID, published alongside the public id.
slugstringcó thể null
typestring
titlestring
original_titlestringcó thể null
original_languagestringcó thể null
synopsisstringcó thể null
yearintegercó thể null
release_datestring · datecó thể null
runtime_minutesintegercó thể null
NULL for a series by projection rule - a series answers with episode_count instead.
episode_countintegercó thể null
season_countintegercó thể null
season_numberintegercó thể null
episode_numberintegercó thể null
statusstringcó thể null
first_air_datestring · datecó thể null
last_air_datestring · datecó thể null
countriesstring[]
genresGenre[]
certificationsCertification[]
ratingsRating[]
aka_titlesAka[]
awardsobject · Awardscó thể null
productionobject · Productioncó thể null
posterobject · Imagecó thể null
backdropobject · Imagecó thể null
logoobject · Imagecó thể null
external_idsobject · ExternalIds
Every external identifier we hold for a title. ALL THREE KEYS ARE ALWAYS PRESENT, with null where we hold nothing. A caller mapping our catalogue onto their own has to distinguish "no IMDb id exists for this title" from "this response shape does not carry IMDb ids", and only an explicit null does that. The free consumer surface publishes none of these by design (M-1); publishing them here is the paid API's proposition - an id you can join on.
updated_atstring · date-timecó thể null
When this record last changed - the field a mirror diffs on.
languagestring
The locale actually served, echoed back. A caller asking for a language we hold nothing in gets English text and this field saying so, rather than silently believing the request was honoured.
creditsobject · Creditscó thể null
Present only when append=credits was asked for. Null otherwise - never an empty object, which would read as 'this title has no credits'.
imagesImage[]có thể null
Present only when append=images was asked for.
similarRecommendation[]có thể null
Present only when append=similar was asked for.

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

The typed title record. Accepts a public id or the catalog UUID, and publishes both back.

Episodes are titles and this endpoint serves them - an ep_ id resolves here exactly as an mv_ one does.

A merged record answers 200 with the survivor's body and a Content-Location header naming it, rather than a redirect - a redirect would make every integrator handle an HTTP concern to read a record. A removed record answers 410 carrying no reason and no editorial status, deliberately indistinguishable between a moderator takedown and any other removal.

Dùng thử

Đang tải khóa demo…

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

Ví dụ

{
  "id": "mv_3RGB99HMTQ",
  "uuid": "9c2a98f3-80be-4b59-940e-57ea9006b9d2",
  "slug": "gladiator-ii-2024",
  "type": "movie",
  "title": "Gladiator II",
  "original_title": "Gladiator II",
  "original_language": "en",
  "synopsis": "Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered...",
  "year": 2024,
  "release_date": null,
  "runtime_minutes": 148,
  "episode_count": null,
  "season_count": null,
  "season_number": null,
  "episode_number": null,
  "status": "released",
  "first_air_date": null,
  "last_air_date": null,
  "countries": [
    "US"
  ],
  "genres": [
    {
      "id": 1,
      "slug": "action",
      "name": "Action"
    },
    {
      "id": 2,
      "slug": "adventure",
      "name": "Adventure"
    }
  ],
  "certifications": [
    {
      "country": "US",
      "certification": "R",
      "meaning": "Under 17 requires accompanying parent or adult guardian 21 or older. The parent/guardian is required to stay with the child under 17 through the entire..."
    }
  ],
  "ratings": [
    {
      "source": "IMDB",
      "score": 6.4,
      "max_score": 10,
      "vote_count": 313588
    },
    {
      "source": "METACRITIC",
      "score": 64,
      "max_score": 100,
      "vote_count": null
    }
  ],
  "aka_titles": [
    {
      "title": "Gladiator II",
      "locale": "en"
    },
    {
      "title": "GladIIator",
      "locale": null
    }
  ],
  "awards": {
    "summary": "Nominated for 1 Oscar. 9 wins & 113 nominations total",
    "highlight_award": "Oscar",
    "highlight_count": 1,
    "total_wins": 9,
    "total_nominations": 113
  },
  "production": {
    "companies": [
      "Paramount Pictures",
      "Scott Free Productions"
    ],
    "countries": [
      "US"
    ],
    "networks": [],
    "tagline": "Prepare to be entertained.",
    "first_air_date": null,
    "last_air_date": null
  },
  "poster": {
    "url": "https://images.example.com/catalog/9c2a98f3-80be-4b59-940e-57ea9006b9d2/primary_poster/en/v1/w500.webp",
    "width": 2000,
    "height": 3000,
    "language": "en",
    "kind": "poster"
  },
  "backdrop": {
    "url": "https://images.example.com/catalog/9c2a98f3-80be-4b59-940e-57ea9006b9d2/title_backdrop/en/v1/w1920.webp",
    "width": 3840,
    "height": 2160,
    "language": "en",
    "kind": "backdrop"
  },
  "logo": {
    "url": "https://images.example.com/catalog/9c2a98f3-80be-4b59-940e-57ea9006b9d2/title_logo/en/v1/w400.webp",
    "width": 4318,
    "height": 1029,
    "language": "en",
    "kind": "logo"
  },
  "external_ids": {
    "imdb_id": "tt9218128",
    "tmdb_id": "558449",
    "tvdb_id": null
  },
  "updated_at": "2026-09-08T05:22:15.368055Z",
  "language": "en",
  "credits": null,
  "images": null,
  "similar": null
}