Wambesha

مرجع API متوفر باللغة الإنجليزية فقط.

Titles

GET/v1/titles

حصة الاستدعاءات فقط

Up to 100 title records in one call, in the order asked; unknown or withdrawn ids come back in missing rather than failing the call. Spends no verification.

المعاملات

idsstringمطلوب
Comma-separated public ids or UUIDs, 1-100 after removing duplicates.
المزيد
Comma-separated public ids or UUIDs. Between 1 and 100; outside that range is a 400.
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.

حقول الاستجابة

itemsTitle[]
missingstring[]
The ids that resolved to nothing, exactly as supplied.

ترويسات الاستجابة

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-Modeمع مفتاح العرض التجريبي فقط
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.

الأخطاء

التفاصيل

Batch title resolution.

Counts as ONE call, not one per id - a documented commitment. Results come back in the order asked, and an unresolvable id lands in missing rather than failing the request.

جرّبها

جارٍ تحميل مفتاح العرض التجريبي…

curl "https://api.wambesha.com/v1/titles?ids=mv_3RGB99HMTQ%2Csr_ZGSKFCDMQ0" \
  -H "Authorization: Bearer YOUR_API_KEY"

مثال

{
  "items": [
    {
      "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
    },
    {
      "id": "sr_ZGSKFCDMQ0",
      "uuid": "3a1beb79-625d-46b8-aeb1-ff33d255c8b9",
      "slug": "ahsoka-2023",
      "type": "series",
      "title": "Ahsoka",
      "original_title": "Ahsoka",
      "original_language": "en",
      "synopsis": "Former Jedi Knight Ahsoka Tano investigates an emerging threat to a vulnerable galaxy.",
      "year": 2023,
      "release_date": null,
      "runtime_minutes": null,
      "episode_count": 1,
      "season_count": 2,
      "season_number": null,
      "episode_number": null,
      "status": "airing",
      "first_air_date": "2023-08-22",
      "last_air_date": "2023-10-03",
      "countries": [
        "US"
      ],
      "genres": [
        {
          "id": 1,
          "slug": "action",
          "name": "Action"
        },
        {
          "id": 2,
          "slug": "adventure",
          "name": "Adventure"
        }
      ],
      "certifications": [
        {
          "country": "US",
          "certification": "TV-14",
          "meaning": "This program contains some material that many parents would find unsuitable for children under 14 years of age."
        }
      ],
      "ratings": [
        {
          "source": "IMDB",
          "score": 7.4,
          "max_score": 10,
          "vote_count": 145108
        },
        {
          "source": "TMDB",
          "score": 7.4,
          "max_score": 10,
          "vote_count": 1322
        }
      ],
      "aka_titles": [
        {
          "title": "Ahsoka",
          "locale": "en"
        },
        {
          "title": "Star Wars : Ahsoka",
          "locale": null
        }
      ],
      "awards": {
        "summary": "Won 1 Primetime Emmy. 7 wins & 36 nominations total",
        "highlight_award": "Primetime Emmy",
        "highlight_count": 1,
        "total_wins": 7,
        "total_nominations": 36
      },
      "production": {
        "companies": [
          "Lucasfilm Ltd.",
          "Golem Creations"
        ],
        "countries": [
          "US"
        ],
        "networks": [
          "Disney+"
        ],
        "tagline": "Warrior. Outcast. Rebel. Jedi.",
        "first_air_date": "2023-08-22",
        "last_air_date": "2023-10-03"
      },
      "poster": {
        "url": "https://images.example.com/catalog/3a1beb79-625d-46b8-aeb1-ff33d255c8b9/primary_poster/en/v1/w500.webp",
        "width": 2000,
        "height": 3000,
        "language": "en",
        "kind": "poster"
      },
      "backdrop": {
        "url": "https://images.example.com/catalog/3a1beb79-625d-46b8-aeb1-ff33d255c8b9/title_backdrop/en/v1/w1920.webp",
        "width": 3840,
        "height": 2160,
        "language": "en",
        "kind": "backdrop"
      },
      "logo": {
        "url": "https://images.example.com/catalog/3a1beb79-625d-46b8-aeb1-ff33d255c8b9/title_logo/en/v1/w400.webp",
        "width": 4318,
        "height": 1292,
        "language": "en",
        "kind": "logo"
      },
      "external_ids": {
        "imdb_id": "tt13622776",
        "tmdb_id": "114461",
        "tvdb_id": "393187"
      },
      "updated_at": "2026-09-08T06:10:52.808835Z",
      "language": "en",
      "credits": null,
      "images": null,
      "similar": null
    }
  ],
  "missing": []
}