Retrieve parsed Google Search (SERP) results for a query.
Returns the organic results, ads, related searches, knowledge panels, and
pagination for a Google web search — already parsed into structured JSON —
without you having to scrape and parse the SERP HTML yourself.
When to use:
- Programmatic SERP data: rankings, titles, links, snippets for a keyword
- SEO/rank tracking, competitive research, or answer-engine grounding
- Time- or date-bounded searches (recent news-like results, date ranges)
When NOT to use:
- Fetching the content of a specific known URL (use the 'scrape' tool)
- Google News, Jobs, Shopping, or Maps — use the dedicated tool for each
Args:
params (GoogleSearchParams): query (required) plus optional
localization (country_code, gl, hl, uule), pagination (num, start),
date filters (date_range_start/end, time_period), tld, output_format,
include_html, and tbs.
Returns:
str: JSON (default) or CSV containing the structured search results.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.