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 occur."
          },
          "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 some low-quality results -- 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 result in testing. A populated shape (Google sometimes attaches sub-links to a result) is not documented."
          }
        },
        "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": "Usually null (when the query triggers no Google featured-snippet answer box). A populated shape is not documented."
    },
    "result_count": {
      "type": "number",
      "description": "Number of entries in `results`."
    },
    "knowledge_graph": {
      "type": "null",
      "description": "Usually null (when the query triggers no Google Knowledge Graph panel). A populated shape is not documented."
    },
    "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.",
  "additionalProperties": true
}