Input Schema

{
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
        "q": {
            "type": "string",
            "maxLength": 120,
            "minLength": 2,
            "description": "Or, instead of ids: what to show, in plain words, searched and shown in one call"
        },
        "ids": {
            "type": "array",
            "items": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "maxItems": 12,
            "minItems": 1,
            "description": "Deal ids from search_deals or catalog_slice, in the order to show them"
        },
        "sort": {
            "enum": [
                "relevance",
                "discount",
                "price_low",
                "price_high"
            ],
            "type": "string",
            "description": "relevance (default), discount (biggest first), price_low, price_high"
        },
        "type": {
            "type": "string",
            "maxLength": 60
        },
        "brand": {
            "type": "string",
            "maxLength": 60
        },
        "limit": {
            "type": "integer",
            "maximum": 12,
            "minimum": 1,
            "description": "With q: how many tiles (default 6)"
        },
        "title": {
            "type": "string",
            "maxLength": 80,
            "description": "A short header over the tiles, e.g. 'Three standing desks under $300'"
        },
        "gender": {
            "enum": [
                "men",
                "women"
            ],
            "type": "string",
            "description": "Only products made for men, or for women"
        },
        "layout": {
            "enum": [
                "row",
                "grid",
                "list",
                "single",
                "compare"
            ],
            "type": "string",
            "description": "row (default): a scrolling row of tiles; grid: tiles in a grid; list: one line per deal; single: one deal, larger; compare: a side-by-side table of price, earlier price, shop and Fazy's price fact"
        },
        "category": {
            "type": "string",
            "maxLength": 24,
            "description": "A category key from list_categories, e.g. 'home', 'footwear'"
        },
        "in_stock": {
            "type": "boolean"
        },
        "max_price": {
            "type": "number",
            "exclusiveMinimum": 0
        },
        "min_price": {
            "type": "number",
            "exclusiveMinimum": 0
        },
        "fresh_only": {
            "type": "boolean",
            "description": "true keeps only prices read from the retailer in the last 24 hours"
        },
        "has_price_fact": {
            "type": "boolean",
            "description": "true keeps only deals whose price Fazy's own record backs (price_fact is set)"
        },
        "min_discount_pct": {
            "type": "integer",
            "maximum": 95,
            "minimum": 1,
            "description": "Only deals at least this much below the retailer's reference price, e.g. 40"
        }
    },
    "additionalProperties": false
}