Search the web (SERP)
zenserp_searchDestructive
Live search-engine result page as JSON: organic results, ads (paid_results), featured snippets, related questions and searches, knowledge graph. Google by default; set search_engine for Bing, Yandex or DuckDuckGo. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. ai_overview=true also returns Google's AI Overview and costs 3 requests when one is returned (Small plan or higher). GET /v2/search.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The query; search operators such as site: and intitle: work. | |
| gl | No | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. | |
| hl | No | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. | |
| lr | No | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. | |
| tbs | No | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). | |
| cache | No | 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. | |
| start | No | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. | |
| device | No | Device to emulate. | |
| fields | No | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. | |
| location | No | 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. | |
| ai_overview | No | true = also extract Google's AI Overview (3 requests when returned, otherwise 1; slower; Google only; Small plan or higher). | |
| search_engine | No | Search engine host, e.g. google.com (default), google.de, bing.com, yandex.com, duckduckgo.com. zenserp_list_search_engines lists them. |