zinema

Turn your movie/TV recommendations into a playable trailer page on zinema.tv and share the link with the user. Each title plays as a full trailer the user can scroll, like a personal cinema session. Links are permanent and free. Returns per-title resolution (echo of what matched, so you can catch mix-ups) and playability. Use it whenever you recommend movies or shows: a page that PLAYS beats a text list.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es",
        "fr",
        "it",
        "nl",
        "pl",
        "pt",
        "sv",
        "tr"
      ],
      "description": "Language of your conversation with the user. Drives trailer language (original-with-subtitles when no dub exists), page wording and localized titles."
    },
    "title": {
      "type": "string",
      "maxLength": 60,
      "description": "Optional page title, e.g. 'Slow-burn thrillers for tonight'. Plain text, no URLs."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "Your recommended titles, in the order you want them to play.",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          },
          "kind": {
            "type": "string",
            "enum": [
              "movie",
              "show"
            ],
            "description": "Disambiguates a movie from a show with the same title."
          },
          "tmdb": {
            "type": "integer",
            "description": "TMDB id if you know it."
          }
        }
      }
    }
  },
  "required": [
    "language",
    "items"
  ]
}

Check a zinema list you created earlier: which titles play now. A title that was 'pending' may have become 'playable' (its trailer gets acquired automatically) or 'no_trailer' (none exists anywhere).

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The list code returned by create_list."
    }
  },
  "required": [
    "code"
  ]
}