{
  "id": "litescrape.google.ai-overview",
  "object": "tool",
  "name": "Get AI Overview",
  "summary": "Get Google's AI Overview for a query, or a free 404 when Google generates none.",
  "description": "Run a Google search and wait for the AI Overview module. Returns ai_overview (text_blocks with snippets and the sources they cite) plus search_metadata and the normalized search_parameters. Supports the full Google Search contract: query or entity (ludocid, kgmid), localization, a named or coordinate origin, verticals, date and safe-search filters, and advanced operators. Answers a 404 that is not charged when Google shows no overview; allow up to 120 seconds. For the full results page with the same parameters use google/search. Suited for AI-answer monitoring, citation tracking, and GEO research.\n\nRaw litescrape#google/ai-overview endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://litescrape.com/docs/google-ai-overview).",
  "category": "lookup",
  "hosted_by": "Litescrape",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "litescrape",
      "name": "Litescrape",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "litescrape_google_ai-overview",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied."
              },
              "ludocid": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Google local CID to search for one entity instead of a query."
              },
              "kgmid": {
                "type": "string",
                "minLength": 1,
                "description": "Knowledge Graph machine ID, such as '/m/0k8z', to search for one entity."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512,
                "description": "Human-readable search origin, such as 'Austin, Texas'. Cannot be combined with uule."
              },
              "uule": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Pre-encoded Google location token. Cannot be combined with location."
              },
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "description": "Latitude of the search origin. Requires lon; cannot be combined with location or uule."
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "description": "Longitude of the search origin. Requires lat; cannot be combined with location or uule."
              },
              "radius": {
                "type": "number",
                "minimum": 1,
                "maximum": 1000,
                "description": "Search-bias radius in meters around location or lat/lon: 1-199 on desktop, 1-1,000 on tablet and mobile."
              },
              "lsig": {
                "type": "string",
                "description": "Opaque Knowledge Graph or local-pack signature from a previous response."
              },
              "si": {
                "type": "string",
                "description": "Opaque cached Google search context from a previous response."
              },
              "ibp": {
                "type": "string",
                "description": "Google layout or expansion control token."
              },
              "uds": {
                "type": "string",
                "description": "Opaque Google filter token from a previous response."
              },
              "color_scheme": {
                "type": "string",
                "enum": [
                  "light",
                  "dark"
                ],
                "description": "Result color presentation."
              },
              "hl": {
                "type": "string",
                "minLength": 2,
                "maxLength": 32,
                "description": "Interface and result language, such as 'en', 'en-GB', or 'de'. Default 'en'."
              },
              "gl": {
                "type": "string",
                "pattern": "^[a-zA-Z]{2}$",
                "description": "Two-letter country code for result localization, such as 'us'."
              },
              "google_domain": {
                "type": "string",
                "minLength": 1,
                "description": "Google domain to query, such as 'google.com' or 'google.co.uk'. Default 'google.com'."
              },
              "device": {
                "type": "string",
                "enum": [
                  "desktop",
                  "tablet",
                  "mobile"
                ],
                "description": "Device layout Google renders. Default 'desktop'."
              },
              "cr": {
                "type": "string",
                "description": "Country restrictions such as 'countryUS', joined with '|'."
              },
              "lr": {
                "type": "string",
                "description": "Language restrictions such as 'lang_en', joined with '|'."
              },
              "tbs": {
                "type": "string",
                "description": "Google native date or search filter string."
              },
              "safe": {
                "type": "string",
                "enum": [
                  "active",
                  "off"
                ],
                "description": "Adult-content filtering."
              },
              "nfpr": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '1' to exclude auto-corrected queries."
              },
              "filter": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '0' to include similar results Google would otherwise omit."
              },
              "pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization control; '0' asks for non-personalized results."
              },
              "peek_pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization peek flag, forwarded unchanged."
              },
              "tbm": {
                "type": "string",
                "enum": [
                  "lcl",
                  "vid",
                  "nws",
                  "shop",
                  "pts"
                ],
                "description": "Google vertical: lcl (local), vid (video), nws (news), shop (shopping), pts (patents). Images are not supported."
              },
              "start": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Result offset. Default 0."
              },
              "num": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "description": "Best-effort first-page result count, 1-100."
              },
              "as_dt": {
                "type": "string",
                "enum": [
                  "i",
                  "e"
                ],
                "description": "Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch."
              },
              "as_epq": {
                "type": "string",
                "description": "Exact phrase the results must contain."
              },
              "as_eq": {
                "type": "string",
                "description": "Phrase the results must not contain."
              },
              "as_lq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Only pages that link to this URL."
              },
              "as_nlo": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Lower bound of an inclusive numeric range. Requires as_nhi."
              },
              "as_nhi": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Upper bound of an inclusive numeric range. Requires as_nlo."
              },
              "as_oq": {
                "type": "string",
                "description": "Any-of search terms."
              },
              "as_q": {
                "type": "string",
                "description": "Additional all-of search terms."
              },
              "as_qdr": {
                "type": "string",
                "pattern": "^[dwmy]\\d*$",
                "description": "Quick date range: d, w, m, or y with an optional count, such as 'm3'."
              },
              "as_rq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Pages related to this URL."
              },
              "as_sitesearch": {
                "type": "string",
                "minLength": 1,
                "description": "Site hostname to include or exclude."
              },
              "oq": {
                "type": "string",
                "description": "Autocomplete original-query lineage value, forwarded verbatim."
              },
              "gs_lp": {
                "type": "string",
                "description": "Google gs_lp autocomplete-session token, forwarded verbatim."
              },
              "sclient": {
                "type": "string",
                "description": "Google search client identifier, such as 'gws-wiz-serp'."
              }
            },
            "required": [
              "q"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied."
              },
              "ludocid": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Google local CID to search for one entity instead of a query."
              },
              "kgmid": {
                "type": "string",
                "minLength": 1,
                "description": "Knowledge Graph machine ID, such as '/m/0k8z', to search for one entity."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512,
                "description": "Human-readable search origin, such as 'Austin, Texas'. Cannot be combined with uule."
              },
              "uule": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Pre-encoded Google location token. Cannot be combined with location."
              },
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "description": "Latitude of the search origin. Requires lon; cannot be combined with location or uule."
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "description": "Longitude of the search origin. Requires lat; cannot be combined with location or uule."
              },
              "radius": {
                "type": "number",
                "minimum": 1,
                "maximum": 1000,
                "description": "Search-bias radius in meters around location or lat/lon: 1-199 on desktop, 1-1,000 on tablet and mobile."
              },
              "lsig": {
                "type": "string",
                "description": "Opaque Knowledge Graph or local-pack signature from a previous response."
              },
              "si": {
                "type": "string",
                "description": "Opaque cached Google search context from a previous response."
              },
              "ibp": {
                "type": "string",
                "description": "Google layout or expansion control token."
              },
              "uds": {
                "type": "string",
                "description": "Opaque Google filter token from a previous response."
              },
              "color_scheme": {
                "type": "string",
                "enum": [
                  "light",
                  "dark"
                ],
                "description": "Result color presentation."
              },
              "hl": {
                "type": "string",
                "minLength": 2,
                "maxLength": 32,
                "description": "Interface and result language, such as 'en', 'en-GB', or 'de'. Default 'en'."
              },
              "gl": {
                "type": "string",
                "pattern": "^[a-zA-Z]{2}$",
                "description": "Two-letter country code for result localization, such as 'us'."
              },
              "google_domain": {
                "type": "string",
                "minLength": 1,
                "description": "Google domain to query, such as 'google.com' or 'google.co.uk'. Default 'google.com'."
              },
              "device": {
                "type": "string",
                "enum": [
                  "desktop",
                  "tablet",
                  "mobile"
                ],
                "description": "Device layout Google renders. Default 'desktop'."
              },
              "cr": {
                "type": "string",
                "description": "Country restrictions such as 'countryUS', joined with '|'."
              },
              "lr": {
                "type": "string",
                "description": "Language restrictions such as 'lang_en', joined with '|'."
              },
              "tbs": {
                "type": "string",
                "description": "Google native date or search filter string."
              },
              "safe": {
                "type": "string",
                "enum": [
                  "active",
                  "off"
                ],
                "description": "Adult-content filtering."
              },
              "nfpr": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '1' to exclude auto-corrected queries."
              },
              "filter": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '0' to include similar results Google would otherwise omit."
              },
              "pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization control; '0' asks for non-personalized results."
              },
              "peek_pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization peek flag, forwarded unchanged."
              },
              "tbm": {
                "type": "string",
                "enum": [
                  "lcl",
                  "vid",
                  "nws",
                  "shop",
                  "pts"
                ],
                "description": "Google vertical: lcl (local), vid (video), nws (news), shop (shopping), pts (patents). Images are not supported."
              },
              "start": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Result offset. Default 0."
              },
              "num": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "description": "Best-effort first-page result count, 1-100."
              },
              "as_dt": {
                "type": "string",
                "enum": [
                  "i",
                  "e"
                ],
                "description": "Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch."
              },
              "as_epq": {
                "type": "string",
                "description": "Exact phrase the results must contain."
              },
              "as_eq": {
                "type": "string",
                "description": "Phrase the results must not contain."
              },
              "as_lq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Only pages that link to this URL."
              },
              "as_nlo": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Lower bound of an inclusive numeric range. Requires as_nhi."
              },
              "as_nhi": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Upper bound of an inclusive numeric range. Requires as_nlo."
              },
              "as_oq": {
                "type": "string",
                "description": "Any-of search terms."
              },
              "as_q": {
                "type": "string",
                "description": "Additional all-of search terms."
              },
              "as_qdr": {
                "type": "string",
                "pattern": "^[dwmy]\\d*$",
                "description": "Quick date range: d, w, m, or y with an optional count, such as 'm3'."
              },
              "as_rq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Pages related to this URL."
              },
              "as_sitesearch": {
                "type": "string",
                "minLength": 1,
                "description": "Site hostname to include or exclude."
              },
              "oq": {
                "type": "string",
                "description": "Autocomplete original-query lineage value, forwarded verbatim."
              },
              "gs_lp": {
                "type": "string",
                "description": "Google gs_lp autocomplete-session token, forwarded verbatim."
              },
              "sclient": {
                "type": "string",
                "description": "Google search client identifier, such as 'gws-wiz-serp'."
              }
            },
            "required": [
              "ludocid"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied."
              },
              "ludocid": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Google local CID to search for one entity instead of a query."
              },
              "kgmid": {
                "type": "string",
                "minLength": 1,
                "description": "Knowledge Graph machine ID, such as '/m/0k8z', to search for one entity."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512,
                "description": "Human-readable search origin, such as 'Austin, Texas'. Cannot be combined with uule."
              },
              "uule": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2048,
                "description": "Pre-encoded Google location token. Cannot be combined with location."
              },
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "description": "Latitude of the search origin. Requires lon; cannot be combined with location or uule."
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "description": "Longitude of the search origin. Requires lat; cannot be combined with location or uule."
              },
              "radius": {
                "type": "number",
                "minimum": 1,
                "maximum": 1000,
                "description": "Search-bias radius in meters around location or lat/lon: 1-199 on desktop, 1-1,000 on tablet and mobile."
              },
              "lsig": {
                "type": "string",
                "description": "Opaque Knowledge Graph or local-pack signature from a previous response."
              },
              "si": {
                "type": "string",
                "description": "Opaque cached Google search context from a previous response."
              },
              "ibp": {
                "type": "string",
                "description": "Google layout or expansion control token."
              },
              "uds": {
                "type": "string",
                "description": "Opaque Google filter token from a previous response."
              },
              "color_scheme": {
                "type": "string",
                "enum": [
                  "light",
                  "dark"
                ],
                "description": "Result color presentation."
              },
              "hl": {
                "type": "string",
                "minLength": 2,
                "maxLength": 32,
                "description": "Interface and result language, such as 'en', 'en-GB', or 'de'. Default 'en'."
              },
              "gl": {
                "type": "string",
                "pattern": "^[a-zA-Z]{2}$",
                "description": "Two-letter country code for result localization, such as 'us'."
              },
              "google_domain": {
                "type": "string",
                "minLength": 1,
                "description": "Google domain to query, such as 'google.com' or 'google.co.uk'. Default 'google.com'."
              },
              "device": {
                "type": "string",
                "enum": [
                  "desktop",
                  "tablet",
                  "mobile"
                ],
                "description": "Device layout Google renders. Default 'desktop'."
              },
              "cr": {
                "type": "string",
                "description": "Country restrictions such as 'countryUS', joined with '|'."
              },
              "lr": {
                "type": "string",
                "description": "Language restrictions such as 'lang_en', joined with '|'."
              },
              "tbs": {
                "type": "string",
                "description": "Google native date or search filter string."
              },
              "safe": {
                "type": "string",
                "enum": [
                  "active",
                  "off"
                ],
                "description": "Adult-content filtering."
              },
              "nfpr": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '1' to exclude auto-corrected queries."
              },
              "filter": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Set '0' to include similar results Google would otherwise omit."
              },
              "pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization control; '0' asks for non-personalized results."
              },
              "peek_pws": {
                "type": "string",
                "enum": [
                  "0",
                  "1"
                ],
                "description": "Personalization peek flag, forwarded unchanged."
              },
              "tbm": {
                "type": "string",
                "enum": [
                  "lcl",
                  "vid",
                  "nws",
                  "shop",
                  "pts"
                ],
                "description": "Google vertical: lcl (local), vid (video), nws (news), shop (shopping), pts (patents). Images are not supported."
              },
              "start": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Result offset. Default 0."
              },
              "num": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "description": "Best-effort first-page result count, 1-100."
              },
              "as_dt": {
                "type": "string",
                "enum": [
                  "i",
                  "e"
                ],
                "description": "Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch."
              },
              "as_epq": {
                "type": "string",
                "description": "Exact phrase the results must contain."
              },
              "as_eq": {
                "type": "string",
                "description": "Phrase the results must not contain."
              },
              "as_lq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Only pages that link to this URL."
              },
              "as_nlo": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Lower bound of an inclusive numeric range. Requires as_nhi."
              },
              "as_nhi": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Upper bound of an inclusive numeric range. Requires as_nlo."
              },
              "as_oq": {
                "type": "string",
                "description": "Any-of search terms."
              },
              "as_q": {
                "type": "string",
                "description": "Additional all-of search terms."
              },
              "as_qdr": {
                "type": "string",
                "pattern": "^[dwmy]\\d*$",
                "description": "Quick date range: d, w, m, or y with an optional count, such as 'm3'."
              },
              "as_rq": {
                "type": "string",
                "pattern": "^https?:\\/\\/",
                "description": "Pages related to this URL."
              },
              "as_sitesearch": {
                "type": "string",
                "minLength": 1,
                "description": "Site hostname to include or exclude."
              },
              "oq": {
                "type": "string",
                "description": "Autocomplete original-query lineage value, forwarded verbatim."
              },
              "gs_lp": {
                "type": "string",
                "description": "Google gs_lp autocomplete-session token, forwarded verbatim."
              },
              "sclient": {
                "type": "string",
                "description": "Google search client identifier, such as 'gws-wiz-serp'."
              }
            },
            "required": [
              "kgmid"
            ],
            "additionalProperties": false
          }
        ],
        "description": "Provide at least one of q, ludocid, or kgmid."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "kind": "endpoint"
}