Skip to main content
GET
cURL
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

Example request

Response schema

Includes common response fields plus:

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.

Authorizations

X-API-Key
string
header
required

Your ScrapeLLM API key passed in the request header.

Query Parameters

prompt
string
required

The prompt to send to Gemini. Maximum 4,000 characters.

Required string length: 1 - 4000
country
string
default:US

ISO 3166-1 alpha-2 country code. Routes the request through infrastructure in that region for localised responses. JP and TW are not supported. Defaults to US.

Required string length: 2
bypass_cache
boolean
default:false

Skip the response cache and always fetch a fresh result.

timeout
number<float>
default:300

Maximum seconds to wait for Gemini to respond. Must be between 10 and 600.

Required range: 10 <= x <= 600

Response

Scrape completed successfully.

scraper
string
required

Always "gemini".

Example:

"gemini"

status
string
required

"done" on success.

Example:

"done"

job_id
string
required

Unique identifier for this scrape job.

Example:

"job_abc123"

prompt
string
required

The prompt that was submitted.

Example:

"What brands do marketers recommend for email automation?"

country
string
required

The country the request was routed through.

Example:

"US"

result
string
required

Plain-text response from Gemini.

Example:

"Marketers commonly recommend Mailchimp, HubSpot, and Klaviyo..."

credits_used
integer
required

Credits consumed by this request. Always 3 for Gemini.

Example:

3

elapsed_ms
number<float>
required

Total end-to-end request duration in milliseconds.

Example:

6521.8

cached
boolean
required

true if this response was served from cache.

Example:

false

result_markdown
string | null

Markdown-formatted response from Gemini with inline citation markers.

Example:

"Marketers commonly recommend **Mailchimp**, **HubSpot**, and **Klaviyo**..."

citations
object[]

Sources cited by Gemini. Gemini provides the richest citation metadata of any AI platform — each source includes a snippet, highlighted passages, and site name.

llm_model
string | null

Gemini model variant used (e.g. gemini-2.0-flash).

Example:

"gemini-2.0-flash"

markdown_url
string | null

Hosted .md URL for this response. Expires after 24 hours.

Example:

"https://scrapellm.com/md/job_abc123.md"