Web & News Search Snippets

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "search query"
    },
    "mode": {
      "enum": [
        "web",
        "news"
      ],
      "type": "string",
      "default": "web",
      "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"
    },
    "page": {
      "type": "string",
      "default": "1",
      "description": "result page (pagination)"
    },
    "engine": {
      "type": "string",
      "default": "auto",
      "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'"
    },
    "region": {
      "type": "string",
      "default": "us-en",
      "description": "locale, e.g. us-en, uk-en, de-de"
    },
    "timelimit": {
      "enum": [
        "d",
        "w",
        "m",
        "y"
      ],
      "type": "string",
      "description": "restrict to past day/week/month/year"
    },
    "safesearch": {
      "enum": [
        "on",
        "moderate",
        "off"
      ],
      "type": "string",
      "default": "moderate"
    },
    "num_results": {
      "type": "string",
      "default": "10",
      "description": "max results, cap 25"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Number of items in `items` for this call. 10 on both captured fixtures."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "ISO 8601 publish date/time. Observed on every item of the news-mode fixture only; not present on the web-mode fixture's items at all (not merely empty)."
          },
          "rank": {
            "type": "integer",
            "description": "1-based result position."
          },
          "type": {
            "type": "string",
            "description": "'search_result' observed on the web-mode fixture, 'news_result' observed on the news-mode fixture."
          },
          "engine": {
            "type": "string",
            "description": "The backend search engine that served this result (e.g. 'auto' on both fixtures -- the input schema documents pinnable alternatives such as yahoo, yandex, bing that were not exercised by either captured fixture)."
          },
          "source": {
            "type": "string",
            "description": "Publisher/outlet name for the item (e.g. 'Politico', 'UN News'). Observed on every item of the news-mode fixture only; not present on the web-mode fixture's items at all (not merely empty)."
          },
          "snippet": {
            "type": "string",
            "description": "Short excerpt of the result's page text."
          }
        },
        "additionalProperties": true
      }
    }
  },
  "description": "Search results for one query. Shape matches both fixtures: web mode (examples/tesla-web-search.json) and news mode (examples/climate-news-search.json).",
  "additionalProperties": true
}