Google AI Mode
Get Google's AI-generated answer for a query — the synthesized text blocks, cited references, and inline shopping results — as JSON.
POST/api/v2/google/ai-mode
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredThe question to answer (-> q).
Example: Best AI Model 2026
deviceenum<string>SERP layout device: desktop or mobile.
include_htmlbooleanInclude the raw Google HTML in the html field.
hlstringUI language (ISO 639-1).
Example: en
glstringGeo location (ISO 3166-1 alpha-2).
Example: us
google_domainstringRegional Google domain.
locationstringCanonical location name (auto-UULE).
uulestringPre-encoded UULE (takes priority over location).
safeenum<string>SafeSearch: active filters adult content.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.google.ai_mode("Best AI Model 2026")
print(results)Response
"q": "Best AI Model 2026",
"hl": "en",
"gl": "us",
"device": "desktop",
"google_domain": "google.com"
},
],
],
"shopping_results": [],
"credits_used": 1,
"credits_remaining": 49
}