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 Gemini endpoint sends any prompt to the Google Gemini web interface and returns the response as structured JSON. Gemini returns the richest citation metadata of any scraper — each source includes a text snippet, highlighted excerpts, the site’s favicon, and a human-readable website name.
Richest citation metadataGemini citations include highlights — the exact excerpts Gemini pulled from each source to support its answer. No other scraper returns this level of citation detail.

​
Overview

Use this endpoint to track brand citations in Google’s AI ecosystem, research which pages Google’s AI trusts for any topic, and monitor how Gemini presents your brand or competitors. The highlights field shows exactly which sentences from each source Gemini used — useful for content optimisation.

​
Unique features

  • Highlights: The exact excerpts Gemini extracted from each source to support its answer
  • Source snippets: Full text excerpt from each cited page
  • Favicon + website name: Human-readable site identity for each citation
  • Markdown response: Full response as markdown via result_markdown

​
Request parameters

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

​
Example request

curl "https://api.scrapellm.com/scrapers/gemini" \
  -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 response from Gemini
result_markdownstringMarkdown-formatted response
citationsarrayCited sources with rich metadata
citations[].titlestringArticle title of the cited page
citations[].urlstringURL of the cited source
citations[].snippetstringText excerpt from the source page
citations[].highlightsarrayExact excerpts Gemini pulled from this source to support its answer
citations[].website_namestringHuman-readable site name (e.g. "HubSpot Blog")
citations[].faviconstringURL of the site’s favicon
llm_modelstringGemini model used (e.g. gemini-2.0-flash)
credits_usedintegerCredits consumed — always 3 for Gemini
elapsed_msfloatEnd-to-end request duration in milliseconds
cachedbooleantrue if served from cache

​
Common questions

​
What are highlights and how are they different from snippet?

snippet is a general text excerpt from the page. highlights are the specific sentences Gemini extracted and used to ground its answer — they show exactly which parts of the source Gemini considered relevant. Highlights are especially useful for content optimisation: if Gemini highlights your content, that’s strong signal for AI citation potential.

​
How does Gemini compare to Google AI Mode?

Both are Google products but distinct surfaces. Gemini is the standalone AI assistant; Google AI Mode is the AI answer panel within Google Search. They return different citation sets, different source mixes, and serve different user intents. Run both for complete Google AI coverage.