Meta

Full details for a single media item — synopsis, cast, posters, and (for series) the episode list.

The meta endpoint returns the complete description of one media item. wako requests it when the user opens a movie or series detail page. Compared to the lightweight meta previews returned by a catalog, a meta response can include cast, crew, runtime, trailers, and the full list of videos.

Endpoint

HTTP

GET /meta/{type}/{id}.json

{type} is the content kind (movie, series, …) and {id} is the item identifier. The ID is URL-encoded by wako before being sent, so unusual characters are safe.

Movie example

JSON

{
  "meta": {
    "id": "tt0083658",
    "type": "movie",
    "name": "Blade Runner",
    "poster": "https://example.com/poster.jpg",
    "background": "https://example.com/background.jpg",
    "logo": "https://example.com/logo.png",
    "description": "A blade runner must pursue and terminate four replicants…",
    "releaseInfo": "1982",
    "imdbRating": "8.1",
    "runtime": "117 min",
    "genres": ["Sci-Fi", "Drama"],
    "cast": ["Harrison Ford", "Rutger Hauer", "Sean Young"],
    "director": ["Ridley Scott"],
    "writer": ["Hampton Fancher", "David Webb Peoples"],
    "language": "English",
    "country": "United States",
    "trailerStreams": [
      { "ytId": "eogpIG53Cis", "title": "Trailer" }
    ]
  }
}

Series example

JSON

{
  "meta": {
    "id": "tt0903747",
    "type": "series",
    "name": "Breaking Bad",
    "poster": "https://example.com/bb.jpg",
    "description": "A high-school chemistry teacher diagnosed with cancer turns to manufacturing methamphetamine…",
    "videos": [
      {
        "id": "tt0903747:1:1",
        "title": "Pilot",
        "season": 1,
        "episode": 1,
        "released": "2008-01-20",
        "overview": "Walter White, an underpaid chemistry teacher…",
        "thumbnail": "https://example.com/s01e01.jpg"
      },
      {
        "id": "tt0903747:1:2",
        "title": "Cat's in the Bag…",
        "season": 1,
        "episode": 2,
        "released": "2008-01-27"
      }
    ]
  }
}

The meta envelope

The response is wrapped in a top-level { "meta": { … } }. Returning the meta object directly (without the envelope) is rejected by wako.

Meta fields

Every meta preview field (id, type, name, poster, posterShape, background, logo, description, releaseInfo, imdbRating, genres, links) is also valid here — see the Catalog page for their definitions. The meta detail adds the following fields:

Field	Type	Description
`cast`	`string[] \| string`	Top-billed actors. wako accepts an array (preferred) or a single comma-free string.
`director`	`string[] \| string`	Director(s).
`writer`	`string[] \| string`	Writer(s).
`runtime`	`string`	Free-form runtime (`117 min`).
`language`	`string`	Original language.
`country`	`string`	Country of origin.
`awards`	`string`	Free-form awards summary, displayed verbatim.
`website`	`string (URL)`	Official website link.
`released`	`string`	ISO-8601 release date. wako parses this for sorting and calendar features.
`imdb_id`	`string`	Optional escape hatch for add-ons that use their own ID scheme but want wako to cross-link their item with IMDb-based features. When present, wako uses this ID for sync, watchlist, and stream lookups.
`videos`	`object[]`	The list of episodes (for series) or playable variants (for movies). See below.
`trailerStreams`	`object[]`	Modern trailer format. Each entry can have `ytId` (YouTube ID), `url` (direct video), and `title`.
`trailers`	`object[]`	Legacy trailer format. Each entry has `source` (a YouTube ID) and optional `type`. Use `trailerStreams` in new add-ons.
`behaviorHints.defaultVideoId`	`string`	For an item with multiple videos, the ID of the one to play by default if the user taps a generic Play button.
`behaviorHints.hasScheduledVideos`	`boolean`	Set to `true` when some episodes have a future release date — wako displays them with an upcoming indicator.

Videos

For a series, videos is the canonical episode list. Each entry is an object:

Field	Type	Description
`id` required	`string`	The video ID used for the stream lookup. For IMDb-based series, the format is `{imdb-id}:{season}:{episode}`. For add-ons with their own ID scheme, use any stable string — wako forwards it back as-is when fetching streams.
`title`	`string`	Episode title.
`season`	`number`	Season number. Required when you want wako's episode list to group episodes by season.
`episode`	`number`	Episode number within the season.
`released`	`string`	ISO-8601 release date. wako uses this to highlight new episodes and drive calendar reminders.
`overview`	`string`	Episode synopsis.
`thumbnail`	`string (URL)`	Episode still image.
`available`	`boolean`	When `false`, the episode is listed but marked as not yet available.

✓

When IMDb-based IDs are enough

If you serve a series identified by its IMDb ID and follow the tt0903747:1:1 convention for episodes, wako and every other add-on can lookup streams and subtitles for the same episode automatically. You only need a custom video ID when your catalog references content that has no IMDb entry.

Caching

Like catalogs, meta responses accept cacheMaxAge, staleRevalidate, and staleError at the top level of the response. wako honors them in addition to its own short in-memory cache.