Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scrapellm.com/llms.txt

Use this file to discover all available pages before exploring further.

The Google AI Mode endpoint extracts data from Google’s AI Mode panel — the AI-generated answer shown at the top of Google Search results. Unlike Gemini (the standalone assistant), this is the AI answer that appears when users search on Google.com, alongside traditional organic results.
AI answer + organic results togetherThis is the only scraper that returns both the AI-generated answer and the traditional organic search results shown on the same page — giving you a complete picture of Google Search visibility.

​
Overview

Use this endpoint to monitor your brand’s presence in Google’s AI Overviews, track which sources Google cites in its AI answers, and compare AI citation coverage against traditional organic rankings — all from a single request.

​
Unique features

  • Organic search results: Traditional Google search results returned alongside the AI answer
  • AI citations with thumbnails: Each cited source includes a thumbnail image URL and favicon
  • Raw URL capture: The underlying Google Search URL used to generate the response

​
Request parameters

​
prompt
string
required
The search query to send to Google AI Mode. Maximum 4,000 characters.
​
country
string
default:"US"
ISO 3166-1 alpha-2 country code for localised results.
​
bypass_cache
boolean
default:"false"
Skip the response cache and always fetch a fresh result.
​
timeout
float
default:"300"
Maximum seconds to wait for Google to respond (10–600).
3 credits per request

​
Example request

curl "https://api.scrapellm.com/scrapers/google-ai-mode" \
  -H "X-API-Key: YOUR_API_KEY" \
  -G \
  --data-urlencode "prompt=What brands do marketers recommend for email automation?" \
  --data-urlencode "country=US"

​
Response schema

Includes common response fields plus:
FieldTypeDescription
resultstringPlain-text AI-generated answer
result_markdownstringMarkdown-formatted AI answer
citationsarraySources cited in the AI answer
citations[].titlestringArticle title of the cited page
citations[].urlstringURL of the cited source
citations[].snippetstringText excerpt from the source page
citations[].website_namestringHuman-readable site name
citations[].thumbnailstringThumbnail image URL (nullable)
citations[].faviconstringSite favicon URL
search_resultsarrayTraditional organic search results shown alongside the AI answer
search_results[].titlestringPage title of the organic result
search_results[].urlstringURL of the organic result
search_results[].snippetstringSearch result snippet
search_results[].website_namestringSite name
search_results[].thumbnailstringThumbnail image URL (nullable)
raw_urlstringThe Google Search URL used to generate the response
credits_usedintegerCredits consumed — always 3 for Google AI Mode
elapsed_msfloatEnd-to-end request duration in milliseconds
cachedbooleantrue if served from cache

​
Common questions

​
What is the difference between Google AI Mode and Gemini?

Google AI Mode is the AI answer panel shown within Google Search results on google.com. Gemini is Google’s standalone AI assistant at gemini.google.com. They use different models, different citation sources, and serve different user intents. Run both for full Google AI coverage.

​
Are organic search results always present?

No — organic results are only included when Google shows them on the same page as the AI answer. For some queries Google shows only the AI panel; for others it shows both. Check search_results.length before processing.

​
Can I use this for AI Overview monitoring?

Yes. Google AI Mode is the same surface as Google’s AI Overviews. This endpoint captures both the AI answer and the citations, making it the primary tool for AI Overview brand monitoring.