SerpRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/finedata-ai/json-schema/finedata-ai-serp-request-schema.json",
  "title": "SerpRequest",
  "description": "Google search request. The Google URL is built here, never sent by the client.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/finedata-openapi.json#/components/schemas/SerpRequest",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "title": "Q",
      "description": "Search query (1-2048 chars)"
    },
    "gl": {
      "type": "string",
      "title": "Gl",
      "description": "Google country: ISO 3166-1 alpha-2 (e.g. 'us')",
      "default": "us"
    },
    "hl": {
      "type": "string",
      "title": "Hl",
      "description": "Google interface language: ISO 639-1, optional region (e.g. 'en' or 'en-GB')",
      "default": "en"
    },
    "location": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Location",
      "description": "Accepted but unused in P1 (only gl/hl apply)"
    },
    "start": {
      "type": "integer",
      "maximum": 90.0,
      "minimum": 0.0,
      "title": "Start",
      "description": "Result offset; 0-90 in steps of 10 (10 results per page)",
      "default": 0
    },
    "device": {
      "type": "string",
      "title": "Device",
      "description": "Only 'desktop' is supported in P1",
      "default": "desktop"
    },
    "include_html": {
      "type": "boolean",
      "title": "Include Html",
      "description": "Also return the raw Google HTML",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "q"
  ]
}