Google Search
Run a Google web search and get the full structured SERP — organic results, ads, knowledge graph, AI Overview, related questions, and more — as JSON.
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 search query to execute (-> q).
Example: Best AI Model 2026
deviceenum<string>SERP layout device: desktop or mobile.
startnumberResult offset for pagination (0, 10, 20 ...).
include_htmlbooleanInclude the raw Google HTML in the html field.
hlstringUI language (ISO 639-1).
Example: en
glstringGeo location country (ISO 3166-1 alpha-2).
Example: us
google_domainstringRegional Google domain.
Example: google.com
locationstringCanonical location name (auto-encoded to a UULE string).
Example: New York,New York,United States
uulestringPre-encoded UULE (takes priority over location).
lrstringLanguage restrict (lang_XX, e.g. lang_en).
crstringCountry restrict (countryXX, e.g. countryUS).
safeenum<string>SafeSearch: active filters adult content.
nfprbooleanDisable spelling correction / auto-fixes when true.
filterenum<string>'0' disables the similar/omitted-results filter; '1' enables (default).
time_periodenum<string>Time filter: last_hour, last_day, last_week, last_month, last_year.
resolve_ai_overviewbooleandefault:trueResolve a deferred AI Overview inline instead of returning a token.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.google.search("Best AI Model 2026")
print(results)Response