Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "The query; search operators such as site: and intitle: work."
},
"search_engine": {
"type": "string",
"pattern": "^(?:[a-z0-9-]+\\.)+[a-z]{2,24}$",
"description": "Search engine host, e.g. google.com (default), google.de, bing.com, yandex.com, duckduckgo.com. zenserp_list_search_engines lists them."
},
"hl": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$",
"description": "Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes."
},
"gl": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States."
},
"lr": {
"type": "string",
"pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?(\\|lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?){0,9}$",
"description": "Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr."
},
"location": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads."
},
"device": {
"type": "string",
"enum": [
"desktop",
"mobile"
],
"description": "Device to emulate."
},
"start": {
"type": "integer",
"minimum": 0,
"maximum": 990,
"description": "Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query."
},
"tbs": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week)."
},
"ai_overview": {
"description": "true = also extract Google's AI Overview (3 requests when returned, otherwise 1; slower; Google only; Small plan or higher).",
"type": "boolean"
},
"cache": {
"type": "boolean",
"description": "true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged."
},
"fields": {
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"description": "Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same."
}
},
"required": [
"q"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}