Google

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. Migrating Google Custom Search JSON API code? Use the Custom Search compatible endpoint, GET /customsearch/v1: same parameters, same items[] response.

POST/api/v2/google

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

The search query to execute (-> q).

Example: Best AI Model 2026

deviceenum<string>

SERP layout device: desktop or mobile.

startnumber

Result offset for pagination (0, 10, 20 ...).

include_htmlboolean

Include the raw Google HTML in the html field.

hlstring

UI language (ISO 639-1).

Example: en

glstring

Geo location country (ISO 3166-1 alpha-2).

Example: us

google_domainstring

Regional Google domain.

Example: google.com

locationstring

Canonical location name (auto-encoded to a UULE string). On the standard results page it currently localizes the local pack only; add web_only for organic results localized to this location.

Example: New York,New York,United States

uulestring

Pre-encoded UULE (takes priority over location).

lrstring

Language restrict (lang_XX, e.g. lang_en).

crstring

Country restrict (countryXX, e.g. countryUS).

safeenum<string>

SafeSearch: active filters adult content.

nfprboolean

Disable 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:true

Resolve a deferred AI Overview inline instead of returning a token.

web_onlybooleandefault:false

Return Google's Web results only: organic_results localized to location. The local pack, ads, related questions, knowledge graph, top stories, videos and AI Overview are not returned. Same 1 credit.

Notes

Local rankings. On the standard results page, location currently localizes the local pack (local_results) but not organic_results. For organic rankings as seen from a city, send location with web_only: true: you get the organic results for that location and nothing else for now. We will update this page when the standard page localizes organic results too.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.google.search("Best AI Model 2026")
print(results)

Response

"q": "Best AI Model 2026",

"hl": "en",

"gl": "us",

"device": "desktop",

"start": 0,

"google_domain": "google.com"

"page_title": "Best AI Model 2026 - Google Search",

"query_displayed": "Best AI Model 2026",

"total_results": 123,

"time_taken_displayed": 0.19,

"organic_results_state": "Results for exact spelling",

"results_for": "",

"country": "",

"city": ""

"state": "complete",

"local_map": null,

"local_results": null,

"knowledge_graph": null,

"top_stories": [],

"related_questions": [],

"current": 0,

"next": "https://google.com/search?q=Best+AI+Model+2026&sca_esv=30f47fff52a37c75&gl=us&hl=en&ei=Gk5GaqfsBMq8wPAPyriJ0A8&start=10&sa=N&sstk=AU9db-AvSnbVy69qmrUZ…",

"discussions_and_forums": [],

"credits_used": 1,

"credits_remaining": 49

}