# Google search

Get Google search results, including the AI Overview and People also ask. Takes q, fast mode, location and more, all optional. Served by Litescrape.

Get Google search results, including the AI Overview and People also ask. Fresh requests only; saved-query and conversation continuation tokens are not supported.

- Tool ID: `litescrape/google-search`
- Name in the catalog: Google Search
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Web search for agents](/tools/web-search/web-search.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "q": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google Search query, up to 2,048 characters.\n\nRequired unless ludocid, kgmid, or page_token is supplied."
    },
    "fast_mode": {
      "default": false,
      "type": "boolean",
      "description": "Return organic results only, skipping AI Overview and all other result groups.\n\nKeeps search metadata and parameters. Omits cross-module position_absolute. Organic results omit thumbnails."
    },
    "location": {
      "anyOf": [
        {
          "maxLength": 512,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Human-readable city-level location encoded to UULE by Litescrape.\n\nConflicts with uule and lat/lon."
    },
    "uule": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pre-encoded Google location value.\n\nConflicts with location and lat/lon."
    },
    "lat": {
      "anyOf": [
        {
          "maximum": 90,
          "minimum": -90,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Latitude from -90 through 90.\n\nRequires lon and conflicts with location and uule."
    },
    "lon": {
      "anyOf": [
        {
          "maximum": 180,
          "minimum": -180,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Longitude from -180 through 180.\n\nRequires lat and conflicts with location and uule."
    },
    "radius": {
      "anyOf": [
        {
          "maximum": 1000,
          "minimum": 1,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Decimal search-bias radius in meters.\n\nRequires location or lat/lon. Desktop: 1–199; tablet/mobile: 1–1,000."
    },
    "ludocid": {
      "anyOf": [
        {
          "maxLength": 128,
          "pattern": "^\\d+$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google local CID used to search for one entity."
    },
    "lsig": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Opaque Knowledge Graph or local-pack signature."
    },
    "kgmid": {
      "anyOf": [
        {
          "maxLength": 512,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google Knowledge Graph machine ID, such as /m/0k8z."
    },
    "si": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Opaque cached Google search context."
    },
    "ibp": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google layout or expansion control."
    },
    "uds": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Opaque Google filter token."
    },
    "color_scheme": {
      "anyOf": [
        {
          "enum": [
            "light",
            "dark"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google result color presentation."
    },
    "google_domain": {
      "default": "google.com",
      "description": "Results use google.com. Use gl, hl, cr, lr or geography for localization.",
      "type": "string"
    },
    "gl": {
      "anyOf": [
        {
          "pattern": "^[a-z]{2}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Lowercase two-letter country localization code."
    },
    "hl": {
      "default": "en",
      "pattern": "^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$",
      "type": "string",
      "description": "Google interface and result language code."
    },
    "cr": {
      "anyOf": [
        {
          "pattern": "^country[A-Z]{2}(?:\\|country[A-Z]{2})*$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "One or more countryXX restrictions joined with |."
    },
    "lr": {
      "anyOf": [
        {
          "pattern": "^lang_[a-z]{2,3}(?:\\|lang_[a-z]{2,3})*$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "One or more lang_xx restrictions joined with |."
    },
    "tbs": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google native date or search filter string."
    },
    "safe": {
      "anyOf": [
        {
          "enum": [
            "active",
            "off"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google adult-content filtering."
    },
    "nfpr": {
      "anyOf": [
        {
          "enum": [
            "0",
            "1"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google auto-correction control."
    },
    "filter": {
      "anyOf": [
        {
          "enum": [
            "0",
            "1"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google similar-result filtering control."
    },
    "pws": {
      "anyOf": [
        {
          "enum": [
            "0",
            "1"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google personalization control; 0 asks for non-personalized results."
    },
    "peek_pws": {
      "anyOf": [
        {
          "enum": [
            "0",
            "1"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google personalization peek flag, forwarded unchanged."
    },
    "tbm": {
      "anyOf": [
        {
          "enum": [
            "lcl",
            "vid",
            "nws",
            "shop",
            "pts"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google vertical: lcl, vid, nws, shop, or pts. For image searches, use /api/google/images."
    },
    "start": {
      "default": 0,
      "minimum": 0,
      "type": "integer",
      "description": "Non-negative Google result offset.\n\nPrefer page_token to repeating the same search with start=10, start=20, or another offset."
    },
    "num": {
      "anyOf": [
        {
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Best-effort first-page result count, 1 to 10."
    },
    "device": {
      "default": "desktop",
      "enum": [
        "desktop",
        "tablet",
        "mobile"
      ],
      "type": "string",
      "description": "Request device profile and radius bound."
    },
    "oq": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Original query associated with an autocomplete selection."
    },
    "gs_lp": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google gs_lp value associated with an autocomplete selection."
    },
    "sclient": {
      "anyOf": [
        {
          "maxLength": 64,
          "pattern": "^[A-Za-z0-9._-]+$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Google client identifier such as gws-wiz-serp."
    },
    "as_dt": {
      "anyOf": [
        {
          "enum": [
            "i",
            "e"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Includes or excludes as_sitesearch.\n\nRequires as_sitesearch."
    },
    "as_epq": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Exact phrase query."
    },
    "as_eq": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Excluded phrase query."
    },
    "as_lq": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Require results that link to this URL."
    },
    "as_nlo": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Inclusive range lower bound.\n\nRequires as_nhi."
    },
    "as_nhi": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Inclusive range upper bound.\n\nRequires as_nlo."
    },
    "as_oq": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Any-of search terms."
    },
    "as_q": {
      "anyOf": [
        {
          "maxLength": 2048,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Additional all-of search terms."
    },
    "as_qdr": {
      "anyOf": [
        {
          "pattern": "^[dwmy](?:[1-9][0-9]*)?$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Quick range d, w, m, or y with an optional positive count."
    },
    "as_rq": {
      "anyOf": [
        {
          "maxLength": 4096,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Find pages related to this URL."
    },
    "as_sitesearch": {
      "anyOf": [
        {
          "maxLength": 253,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Site hostname to include or exclude."
    }
  },
  "type": "object",
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "q"
          ],
          "properties": {
            "q": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        },
        {
          "required": [
            "ludocid"
          ],
          "properties": {
            "ludocid": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        },
        {
          "required": [
            "kgmid"
          ],
          "properties": {
            "kgmid": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        }
      ]
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/google-search",
  "input": {
    "q": "python documentation",
    "num": 3,
    "fast_mode": true
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#search-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/google-search) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/google-search) · [Agent index](/llms.txt)