Google AI Mode results

{
  "operationId": "google_ai_mode_search",
  "method": "post",
  "path": "/serp-ai-mode",
  "summary": "Google AI Mode results",
  "description": "Runs the query through Google's AI Mode and returns the AI-generated answer with its cited sources and references. Use it to see how Google's AI answers a question and which pages it cites, which is the core check for answer-engine optimization: is your (or a competitor's) content being used as a source? Costs about 2x a classic search.",
  "parameters": [],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "keyword"
          ],
          "properties": {
            "keyword": {
              "type": "string",
              "maxLength": 700,
              "description": "The question or query to run through Google AI Mode."
            },
            "location_code": {
              "type": "integer",
              "description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany.",
              "default": 2840
            },
            "language_code": {
              "type": "string",
              "description": "Two-letter language code, e.g. 'en' (default).",
              "default": "en"
            }
          }
        },
        "example": {
          "keyword": "what is the best email warmup tool"
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "The AI-generated answer with cited sources in `result[0].items`.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request or upstream task error."
    },
    {
      "statusCode": "401",
      "description": "Unauthorized."
    },
    {
      "statusCode": "429",
      "description": "Too many requests."
    },
    {
      "statusCode": "5XX",
      "description": "Upstream error."
    }
  ]
}