google_search
Parse Google search results for SEO research, keyword discovery, and SERP feature analysis. Retrieve organic listings, featured snippets, and knowledge graph data for any query and locale.
Instructions
Parse Google search results page (SERP) for a given query and locale.
Use this for: SEO research (own/competitor ranking), keyword discovery, SERP feature analysis (featured snippets, knowledge graph, FAQ), competitive intel.
Do NOT use for: live page content fetching (use a dedicated scraper for that),
Google Ads keyword planner data (use Yandex Wordstat via wordstat_query for RU).
Returns:
Dict with:
- query (echoed)
- total_found — Google's reported result count
- page — page number
- results — list of organic results with position, url, title, snippet
- addresults — featured_snippet, related_questions, related_searches,
knowledge_graph (if present and requested via additional_blocks)
- Or isError: True on XMLRiver error (15 = no results, 110 = rate limit, etc).
Examples: google_search(query="python tutorial", country=2008, language="ru") → {"results": [...10 organic results...], "total_found": 12300, "page": 1}
google_search(query="site:wikipedia.org python", country=2840, language="en")
→ results restricted to wikipedia.org domainInput Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query. Plain text or with Google operators (site:, inurl:, etc). Example: 'купить iphone 15' or 'site:wikipedia.org openai'. | |
| country | No | Country ID for Google location. Default 2008 (Russia). Common values: 2008=RU, 2840=US, 2826=UK, 2276=DE, 2250=FR, 2724=ES, 2484=MX. Full list: https://xmlriver.com/apidoc/country/ | |
| domain | No | Google domain ID. Default 10 (google.com). Common: 10=google.com, 11=google.co.uk, 53=google.com.tr, 84=google.ru. Full list: https://xmlriver.com/apidoc/domain/ | |
| language | No | Interface language code (Google `lr` param). Examples: 'ru' (Russian), 'en' (English), 'de' (German), 'es' (Spanish). Default 'ru'. | ru |
| device | No | Device emulation. Default 'desktop'. | desktop |
| page | No | Page number (1-based). Default 1. | |
| location | No | Optional precise location ID (Google `loc` param). Overrides country/region with city-level precision. Full list: https://xmlriver.com/apidoc/loc/ | |
| date_filter | No | Date filter (Google `tbs` param). Examples: 'qdr:h' (last hour), 'qdr:d' (24h), 'qdr:w' (week), 'qdr:m' (month), 'qdr:y' (year), or custom 'cdr:1,cd_min:1/1/2024,cd_max:6/1/2024'. | |
| additional_blocks | No | Comma-separated extra blocks to parse: 'topads,bottomads,faqsnippet,rq,rs,knowledge_graph,sitelinks,g_news,g_videos,g_inlineshopping,searchsters,scroller,extended_snippet'. Each adds parsing cost on XMLRiver side but no extra charge. | |
| ai_overview | No | Parse Google's AI Overview block (slower, costs extra). Default False. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||