Raw schema
{
"type": "object",
"properties": {
"seeds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"minItems": 1,
"maxItems": 3,
"description": "1-3 games the user likes: names, Steam appids or Steam URLs."
},
"liked": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"maxItems": 10,
"description": "Other games the user said they liked (e.g. from earlier answers). They fill free seed slots after `seeds` (3 in all); the rest are listed in `ignored`."
},
"disliked": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"maxItems": 20,
"description": "Games the user disliked or already played: never recommended. Pass earlier picks the user rejected to get fresh ones."
},
"filters": {
"type": "object",
"description": "All optional. Leave out what the user did not ask for.",
"properties": {
"free": {
"type": "boolean",
"description": "Only free-to-play games."
},
"coop": {
"type": "boolean",
"description": "Only games with co-op."
},
"coop_mode": {
"type": "string",
"enum": [
"online",
"local",
"any"
],
"description": "Kind of co-op (implies coop): online (Remote Play Together does not count), local same-screen / split-screen, or any."
},
"deck": {
"type": "string",
"enum": [
"verified",
"playable"
],
"description": "Steam Deck verified, or playable-or-better."
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pvp",
"microtransactions",
"hard",
"grind",
"early_access",
"vr_only"
]
},
"description": "Leave out: pvp (PvP-focused), microtransactions (in-app purchases / free-to-play), hard (Difficult / Souls-like), grind (MMO / looter grind), early_access, vr_only."
},
"exclude_tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "Steam tags to leave out, e.g. ['Horror', 'Anime']."
},
"year_min": {
"type": "integer",
"minimum": 1970,
"maximum": 2100,
"description": "Released in or after this year."
},
"year_max": {
"type": "integer",
"minimum": 1970,
"maximum": 2100,
"description": "Released in or before this year (default: this year)."
},
"upcoming": {
"type": "boolean",
"description": "Also include unreleased games (no year_max default)."
},
"popularity_bias": {
"type": "number",
"minimum": -1,
"maximum": 1,
"description": "-1 = hidden gems / more niche, 0 = neutral, 1 = well-known / more popular. Rounded to steps of 0.5."
}
},
"additionalProperties": false
},
"preferences": {
"type": "string",
"maxLength": 200,
"description": "What the user wants or wants to avoid, in their words (any language), e.g. 'dragons and crafting, no horror, no grind'. Read as Steam tags."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"required": [
"seeds"
],
"additionalProperties": false
}