Web Search (SERP)

Admitted input schema

{
  "type": "object",
  "properties": {
    "engine": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "search backend: auto (recommended - rotates engines and falls back on blocks) or pin one of yahoo, yandex (web mode); news mode supports bing. when set, each result carries an 'engine' field; if the pinned engine returns nothing, auto serves instead and results also carry 'requestedEngine'",
      "default": "auto"
    },
    "mode": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "web",
        "news"
      ],
      "description": "web results or recent news (news adds date+source per item). the news index is narrow, so a long or highly specific news query that matches nothing falls through to web rather than returning empty; those items carry requestedMode=news and servedBy=web",
      "default": "web"
    },
    "num_results": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "max results, cap 25",
      "default": "10"
    },
    "page": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "result page (pagination)",
      "default": "1"
    },
    "q": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "search query"
    },
    "region": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "locale, e.g. us-en, uk-en, de-de",
      "default": "us-en"
    },
    "safesearch": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "on",
        "moderate",
        "off"
      ],
      "default": "moderate"
    },
    "timelimit": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "d",
        "w",
        "m",
        "y"
      ],
      "description": "restrict to past day/week/month/year"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}