Google Search Autocomplete Suggestions (United States, English)

{
  "type": "object",
  "required": [
    "keyword",
    "location_code",
    "language_code"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 700,
      "minLength": 1,
      "description": "The search term to get autocomplete suggestions for, in plain text."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The search language; only \"en\" (English), the one tested, is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The search location; only 2840 (United States), the one tested, is offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "relevance": {
                  "type": "number",
                  "description": "Google's relevance score for it."
                },
                "suggestion": {
                  "type": "string",
                  "description": "The suggested query text."
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "Position in the list, from 1."
                }
              }
            },
            "description": "The suggestions, in the order Google lists them."
          },
          "keyword": {
            "type": "string",
            "description": "The search term, echoed back."
          },
          "items_count": {
            "type": "number",
            "description": "How many suggestions came back."
          }
        }
      }
    }
  },
  "description": "The autocomplete result, wrapped as `{results: [...]}` (one entry per call)."
}