Get Google search results, including the AI Overview and People also ask.
View input schema
{
"type": "object",
"properties": {
"page_token": {
"anyOf": [
{
"maxLength": 32768,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Page Token",
"description": "Opaque token from pagination.next_page_token. Send it alone to fetch the next page with the original search parameters.\n\nPrefer page_token to repeating the same search with start=10, start=20, or another offset. Send the token as soon as possible and no later than 5 minutes after receiving it. Available for ordinary Google Search, including fast mode; not available for tbm verticals. search_metadata.continuation is followed for a direct request. If Google omits a required link or the deadline expires, the request fails without billing."
},
"q": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Q",
"description": "Google Search query, up to 2,048 characters.\n\nRequired unless ludocid, kgmid, or page_token is supplied."
},
"fast_mode": {
"default": false,
"title": "Fast Mode",
"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."
},
"location": {
"anyOf": [
{
"maxLength": 512,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location",
"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"
}
],
"default": null,
"title": "Uule",
"description": "Pre-encoded Google location value.\n\nConflicts with location and lat/lon."
},
"lat": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat",
"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"
}
],
"default": null,
"title": "Lon",
"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"
}
],
"default": null,
"title": "Radius",
"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"
}
],
"default": null,
"title": "Ludocid",
"description": "Google local CID used to search for one entity."
},
"lsig": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Lsig",
"description": "Opaque Knowledge Graph or local-pack signature."
},
"kgmid": {
"anyOf": [
{
"maxLength": 512,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kgmid",
"description": "Google Knowledge Graph machine ID, such as /m/0k8z."
},
"si": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Si",
"description": "Opaque cached Google search context."
},
"ibp": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ibp",
"description": "Google layout or expansion control."
},
"uds": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Uds",
"description": "Opaque Google filter token."
},
"color_scheme": {
"anyOf": [
{
"enum": [
"light",
"dark"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Color Scheme",
"description": "Google result color presentation."
},
"google_domain": {
"default": "google.com",
"description": "Results use google.com. Use gl, hl, cr, lr or geography for localization.",
"title": "Google Domain",
"type": "string"
},
"gl": {
"anyOf": [
{
"pattern": "^[a-z]{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Gl",
"description": "Lowercase two-letter country localization code."
},
"hl": {
"default": "en",
"pattern": "^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$",
"title": "Hl",
"type": "string",
"description": "Google interface and result language code."
},
"cr": {
"anyOf": [
{
"pattern": "^country[A-Z]{2}(?:\\|country[A-Z]{2})*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cr",
"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"
}
],
"default": null,
"title": "Lr",
"description": "One or more lang_xx restrictions joined with |."
},
"tbs": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tbs",
"description": "Google native date or search filter string."
},
"safe": {
"anyOf": [
{
"enum": [
"active",
"off"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Safe",
"description": "Google adult-content filtering."
},
"nfpr": {
"anyOf": [
{
"enum": [
"0",
"1"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Nfpr",
"description": "Google auto-correction control."
},
"filter": {
"anyOf": [
{
"enum": [
"0",
"1"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Filter",
"description": "Google similar-result filtering control."
},
"pws": {
"anyOf": [
{
"enum": [
"0",
"1"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pws",
"description": "Google personalization control; 0 asks for non-personalized results."
},
"peek_pws": {
"anyOf": [
{
"enum": [
"0",
"1"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Peek Pws",
"description": "Google personalization peek flag, forwarded unchanged."
},
"tbm": {
"anyOf": [
{
"enum": [
"lcl",
"vid",
"nws",
"shop",
"pts"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tbm",
"description": "Google vertical: lcl, vid, nws, shop, or pts. For image searches, use /api/google/images."
},
"start": {
"default": 0,
"minimum": 0,
"title": "Start",
"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"
}
],
"default": null,
"title": "Num",
"description": "Best-effort first-page result count, 1 to 10."
},
"device": {
"default": "desktop",
"enum": [
"desktop",
"tablet",
"mobile"
],
"title": "Device",
"type": "string",
"description": "Request device profile and radius bound."
},
"oq": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Oq",
"description": "Original query associated with an autocomplete selection."
},
"gs_lp": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Gs Lp",
"description": "Google gs_lp value associated with an autocomplete selection."
},
"sclient": {
"anyOf": [
{
"maxLength": 64,
"pattern": "^[A-Za-z0-9._-]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sclient",
"description": "Google client identifier such as gws-wiz-serp."
},
"as_dt": {
"anyOf": [
{
"enum": [
"i",
"e"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Dt",
"description": "Includes or excludes as_sitesearch.\n\nRequires as_sitesearch."
},
"as_epq": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Epq",
"description": "Exact phrase query."
},
"as_eq": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Eq",
"description": "Excluded phrase query."
},
"as_lq": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Lq",
"description": "Require results that link to this URL."
},
"as_nlo": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "As Nlo",
"description": "Inclusive range lower bound.\n\nRequires as_nhi."
},
"as_nhi": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "As Nhi",
"description": "Inclusive range upper bound.\n\nRequires as_nlo."
},
"as_oq": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Oq",
"description": "Any-of search terms."
},
"as_q": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Q",
"description": "Additional all-of search terms."
},
"as_qdr": {
"anyOf": [
{
"pattern": "^[dwmy](?:[1-9][0-9]*)?$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Qdr",
"description": "Quick range d, w, m, or y with an optional positive count."
},
"as_rq": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Rq",
"description": "Find pages related to this URL."
},
"as_sitesearch": {
"anyOf": [
{
"maxLength": 253,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "As Sitesearch",
"description": "Site hostname to include or exclude."
},
"result_groups": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Return only these top-level result groups, e.g. [\"organic_results\", \"knowledge_graph\"]; omit for the complete response. search_metadata is always kept"
}
},
"additionalProperties": false,
"title": "GoogleSearch"
}