Piloterr

Google AI Mode

GET
/v2/google/search/ai

Scrape real-time Google AI Mode answers: text_blocks, reconstructed_markdown, and references.

Status: Experimental

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

The question or search query to send to Google AI Mode. Natural-language questions work best; advanced operators are also accepted.

Examples:

  • what is mozilla firefox: factual overview
  • best espresso machine 2026: comparison-style answer
  • site:mozilla.org firefox privacy: restrict cited sources

Example:

what is mozilla firefox
location?string

City or region from which the AI Mode search should originate. Simulates a real user searching from that location.

Examples:

New York, NY
Paris, France
Tokyo, Japan
uule?string

Google-encoded location string for precise geographic targeting. Mutually exclusive with location.

gl?string

Two-letter country code for the Google AI Mode country context.

  • us: United States
  • fr: France
  • gb: United Kingdom
  • de: Germany

Example:

us
Default"us"
hl?string

Two-letter language code for the Google AI Mode interface language.

  • en: English
  • fr: French
  • de: German
  • es: Spanish

Example:

en
Default"en"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/google/search/ai?query=string"

{  "references": [    {      "link": "https://www.mozilla.org/firefox/",      "index": 0,      "title": "Firefox Browser",      "source": "mozilla.org"    },    {      "link": "https://en.wikipedia.org/wiki/Firefox",      "index": 1,      "title": "Firefox - Wikipedia",      "source": "en.wikipedia.org"    }  ],  "text_blocks": [    {      "type": "paragraph",      "snippet": "Mozilla Firefox is a free, open-source web browser developed by the Mozilla Foundation. It is available on desktop and mobile, supports extensions, and focuses on privacy controls such as Enhanced Tracking Protection."    },    {      "type": "heading",      "snippet": "Key features"    },    {      "list": [        {          "snippet": "Free and open-source, maintained by the Mozilla Foundation."        },        {          "snippet": "Available on desktop and mobile platforms."        },        {          "snippet": "Enhanced Tracking Protection to limit cross-site tracking."        }      ],      "type": "list"    }  ],  "search_parameters": {    "q": "what is mozilla firefox",    "gl": "us",    "hl": "en",    "engine": "google_ai_mode"  },  "reconstructed_markdown": "Mozilla Firefox is a free, open-source web browser developed by the Mozilla Foundation. It is available on desktop and mobile, supports extensions, and focuses on privacy controls such as Enhanced Tracking Protection.\n\n### Key features\n\n- Free and open-source, maintained by the Mozilla Foundation.\n- Available on desktop and mobile platforms.\n- Enhanced Tracking Protection to limit cross-site tracking."}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}