Google Search Snippets, Rank & Related Questions (by Query)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "country": {
      "type": "string",
      "description": "Country to scope results to, as an ISO 3166-1 alpha-2 code (MX), alpha-3 code (MEX), numeric code (484), or exact country name (Mexico). \"UK\" is accepted as an alias for GB. Unrecognised values are rejected before the search runs rather than silently ignored. Omit for unscoped global results."
    },
    "language": {
      "type": "string",
      "description": "Language for results, as an ISO 639-1 code (\"en\"), optionally with a region (\"pt-BR\"). Validated for shape and rejected before the search runs if malformed, rather than silently ignored. Omit for Google's default."
    },
    "num_results": {
      "type": "integer",
      "default": 10,
      "description": "Number of results (default 10, max 20)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query, echoed back exactly as submitted."
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "title",
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "The result's link, as an absolute URL."
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publish date for the result as Google reports it (e.g. '30 Jan 2017'), or null when Google does not report one -- both observed on real fixtures."
          },
          "title": {
            "type": "string",
            "description": "The result's page title as Google displays it. Observed, on a low-quality result for a nonsense query, to literally BE the bare URL string (e.g. 'https://urls.fr/MX_jLo') when the page has no real title Google can extract -- not guaranteed to be human-readable prose."
          },
          "snippet": {
            "type": "string",
            "description": "The result's text snippet/description. Observed missing entirely (no key at all, not merely empty) on one low-quality result in a real fixture -- treat as optional, not guaranteed present."
          },
          "position": {
            "type": "number",
            "description": "1-based rank position of this result in the list."
          },
          "sitelinks": {
            "type": "null",
            "description": "Observed as null on every real result across both fixtures. A populated shape (Google sometimes attaches sub-links to a result) was never observed and is unconfirmed."
          }
        },
        "additionalProperties": true
      },
      "description": "Organic search results in rank order. Observed with 5 entries for a well-formed query (Tesla Inc) and 10 entries for a low-quality/nonsense query -- length is not fixed and depends on how many results Google returns for the input."
    },
    "answer_box": {
      "type": "null",
      "description": "Observed as null on both real fixtures (neither query triggered a Google featured-snippet answer box). A populated shape is unconfirmed."
    },
    "result_count": {
      "type": "number",
      "description": "Number of entries in `results`."
    },
    "knowledge_graph": {
      "type": "null",
      "description": "Observed as null on both real fixtures (neither query triggered a Google Knowledge Graph panel). A populated shape is unconfirmed."
    },
    "people_also_ask": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "question"
        ],
        "properties": {
          "question": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "Google's 'People also ask' follow-up questions. Observed with 4 entries for a well-formed query (Tesla Inc) and empty for a nonsense query."
    },
    "search_parameters": {
      "type": "object",
      "properties": {
        "country": {
          "type": [
            "string",
            "null"
          ],
          "description": "Lowercase country code the search was scoped to (e.g. 'fr'), or null when no country was requested."
        },
        "language": {
          "type": [
            "string",
            "null"
          ],
          "description": "Language code the search was scoped to, or null when none was requested."
        }
      },
      "description": "The country/language scope actually applied to the search.",
      "additionalProperties": true
    }
  },
  "description": "The search result document, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}