Input schema (JSON)
{
"type": "object",
"$defs": {
"Constraints": {
"type": "object",
"title": "Constraints",
"properties": {
"kind": {
"enum": [
"any",
"movie",
"show"
],
"type": "string",
"title": "Kind",
"default": "any"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"title": "Genres",
"maxItems": 5
},
"country": {
"type": "string",
"title": "Country",
"default": "US",
"pattern": "^[A-Z]{2}$",
"description": "Two-letter availability country, such as US or GB. Use known location; US is the default. Does not establish availability unless providers are also supplied."
},
"variety": {
"type": "boolean",
"title": "Variety",
"default": false
},
"year_to": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 1870
},
{
"type": "null"
}
],
"title": "Year To",
"default": null,
"description": "Latest original release year."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"title": "Languages",
"maxItems": 5
},
"providers": {
"type": "array",
"items": {
"type": "string"
},
"title": "Providers",
"maxItems": 5,
"description": "Streaming providers to require. Country and offer_types filter availability only when providers are supplied."
},
"year_from": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 1870
},
{
"type": "null"
}
],
"title": "Year From",
"default": null,
"description": "Earliest original release year. A series uses its first-release year, not the year of a returning season or addition to a service."
},
"exclude_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^tt\\d{5,12}$"
},
"title": "Exclude Ids",
"maxItems": 100,
"description": "Resolved titles to leave out, including a viewer's 'seen it' reaction. Keep earlier constraints when refining. For disliked-title affinities, use avoid_seed_ids on recommend_titles or recommend_for_me instead."
},
"offer_types": {
"type": "array",
"items": {
"enum": [
"subscription",
"free",
"ads",
"rent",
"buy"
],
"type": "string"
},
"title": "Offer Types"
},
"max_movie_minutes": {
"anyOf": [
{
"type": "integer",
"maximum": 600,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Max Movie Minutes",
"default": null,
"description": "Maximum film runtime in minutes. Does not restrict series; set kind=movie for a movie-only request."
},
"max_episode_minutes": {
"anyOf": [
{
"type": "integer",
"maximum": 600,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Max Episode Minutes",
"default": null,
"description": "Maximum runtime per episode in minutes. Does not describe a whole season or restrict films."
}
},
"additionalProperties": false
}
},
"title": "recommend_for_groupArguments",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"title": "GroupRecommendRequest",
"required": [
"group_id"
],
"properties": {
"focus": {
"enum": [
"tonight",
"all_titles"
],
"type": "string",
"title": "Focus",
"default": "tonight",
"description": "tonight gives current trending choices priority alongside shared taste. all_titles explores the wider library. Explicit title or mood references guide either choice."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 12,
"maximum": 12,
"minimum": 1,
"description": "Candidate shortlist size for the assistant to choose from, not the number to show the viewer. Usually retrieve twelve and present two or three fitting choices."
},
"intent": {
"enum": [
"watched",
"loved",
"into"
],
"type": "string",
"title": "Intent",
"default": "loved",
"description": "Evidence emphasis: watched for viewing, loved for ratings, into for topics and mood references. The general title neighborhood is shared. This field does not establish viewer history; qualities express the experience wanted."
},
"group_id": {
"type": "string",
"title": "Group Id",
"maxLength": 64,
"minLength": 1,
"description": "Copy a group_id from get_my_watchplus_groups; a group name or an email is not an identifier."
},
"seed_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^tt\\d{5,12}$"
},
"title": "Seed Ids",
"maxItems": 3,
"description": "Resolved positive reference titles. These can be viewer likes or assistant-chosen examples of a requested mood. A reference alone does not establish that the viewer watched or liked it."
},
"qualities": {
"type": "string",
"title": "Qualities",
"default": "",
"maxLength": 300,
"description": "The experience wanted now: mood, tone, pace, themes and qualities to avoid, in natural language. Preserve refinements such as absorbing but not draining or more playful. This request does not change saved taste."
},
"member_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^wm[1-9]\\d{0,18}$"
},
"title": "Member Ids",
"maxItems": 8,
"description": "Copy member_ids from this group's roster for the people watching now. Empty means everyone, up to eight. Do not infer who is watching from membership alone."
},
"constraints": {
"$ref": "#/$defs/Constraints"
},
"allow_rewatch": {
"type": "boolean",
"title": "Allow Rewatch",
"default": false
},
"avoid_seed_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^tt\\d{5,12}$"
},
"title": "Avoid Seed Ids",
"maxItems": 3,
"description": "Titles the viewer disliked. Reduces candidates closer to these than to the positive references. This differs from exclude_ids, which only hides exact titles. Uses exact versions; a title dislike alone does not specify an unwanted theme."
},
"use_saved_services": {
"type": "boolean",
"title": "Use Saved Services",
"default": false,
"description": "Use only the connected viewer's saved services when no providers are supplied. Does not reveal other members' subscriptions."
}
},
"additionalProperties": false
}
}
}