Google

google

Scrape.do Async-API Google Plugin Adapters

Each adapter pairs a plugin's Key discriminator literal with the list of Sync *Parameters entries the Async API expects

Usage

These adapters participate in the AsyncPlugin discriminated union consumed by JobCreationRequest.plugin

Country Targeting

• The top-level geo_code of the JobCreationRequest cannot be used with plugin-specifc location parameters and has no effect on Google Plugins

• Use the per-param gl instead

super

• All Google Plugins use premium proxies internally by default

• The top-level Super flag on JobCreationRequest has no effect on them

Async-Surface Parity

• Adapters accept every documented sync parameter unchanged

• The one exception is google/search/ai-overview, which has different driver semantics on the async surface. See GoogleSearchAiOverviewAsyncPlugin

Official Documentation

• Async API Plugins
• Google Scraper API

GoogleSearchAsyncPlugin

Bases: BaseModel

Async adapter for the google/search plugin

Attributes:

Name	Type	Description
key	Literal['google/search']	Plugin discriminator
params	List[GoogleSearchParameters]	Per-job task entries (1-1000)

GoogleSearchAiModeAsyncPlugin

Bases: BaseModel

Async adapter for the google/search/ai-mode plugin

Attributes:

Name	Type	Description
key	Literal['google/search/ai-mode']	Plugin discriminator
params	List[GoogleSearchAiModeParameters]	Per-job task entries (1-1000)

GoogleSearchAiOverviewAsyncParameters

Bases: BaseModel

One request for the async google/search/ai-overview plugin

Difference From Sync AI Overview

• The Async API exposes google/search/ai-overview as a standalone plugin by handling both fetch hops internally (the SERP call AND the deferred-state follow-up)

• The session_key follow-up form (GoogleSearchAiOverviewParameters) remains the sync-gateway shape

A/B-Tested Results

• AI Overview is A/B-tested and not every query qualifies

• Queries Google does not return an AI Overview for fail with an explicit error and are not charged

Attributes:

Name	Type	Description
q	str	Search query
gl	Optional[str]	Country-perspective code (default us)
hl	Optional[str]	Interface-language code (default en)
google_domain	Optional[str]	Google domain override (default google.com)
device	Optional[GoogleDeviceType]	Device class to emulate
uule	Optional[str]	Pre-encoded UULE location token
location	Optional[str]	Human-readable location string (auto-encoded to UULE server-side)
safe	Optional[GoogleSafeSearchType]	SafeSearch toggle

GoogleSearchAiOverviewAsyncPlugin

Bases: BaseModel

Async adapter for the google/search/ai-overview plugin

Attributes:

Name	Type	Description
key	Literal['google/search/ai-overview']	Plugin discriminator
params	List[GoogleSearchAiOverviewAsyncParameters]	Per-job task entries (1-1000)

GoogleMapsSearchAsyncPlugin

Bases: BaseModel

Async adapter for the google/maps/search plugin

Attributes:

Name	Type	Description
key	Literal['google/maps/search']	Plugin discriminator
params	List[GoogleMapsSearchParameters]	Per-job task entries (1-1000)

GoogleMapsPlaceAsyncPlugin

Bases: BaseModel

Async adapter for the google/maps/place plugin

Attributes:

Name	Type	Description
key	Literal['google/maps/place']	Plugin discriminator
params	List[GoogleMapsPlaceParameters]	Per-job task entries (1-1000)

GoogleMapsReviewsAsyncPlugin

Bases: BaseModel

Async adapter for the google/maps/reviews plugin

Attributes:

Name	Type	Description
key	Literal['google/maps/reviews']	Plugin discriminator
params	List[GoogleMapsReviewsParameters]	Per-job task entries (1-1000)

GoogleShoppingAsyncPlugin

Bases: BaseModel

Async adapter for the google/shopping plugin

Attributes:

Name	Type	Description
key	Literal['google/shopping']	Plugin discriminator
params	List[GoogleShoppingParameters]	Per-job task entries (1-1000)

GoogleFlightsAsyncPlugin

Bases: BaseModel

Async adapter for the google/flights plugin

Attributes:

Name	Type	Description
key	Literal['google/flights']	Plugin discriminator
params	List[GoogleFlightsParameters]	Per-job task entries (1-1000)

GoogleHotelsAsyncPlugin

Bases: BaseModel

Async adapter for the google/hotels plugin

Attributes:

Name	Type	Description
key	Literal['google/hotels']	Plugin discriminator
params	List[GoogleHotelsParameters]	Per-job task entries (1-1000)

GoogleNewsAsyncPlugin

Bases: BaseModel

Async adapter for the google/news plugin

Attributes:

Name	Type	Description
key	Literal['google/news']	Plugin discriminator
params	List[GoogleNewsParameters]	Per-job task entries (1-1000)

GoogleTrendsAsyncPlugin

Bases: BaseModel

Async adapter for the google/trends plugin

Attributes:

Name	Type	Description
key	Literal['google/trends']	Plugin discriminator
params	List[GoogleTrendsParameters]	Per-job task entries (1-1000)

GoogleTrendingAsyncPlugin

Bases: BaseModel

Async adapter for the google/trending plugin

Attributes:

Name	Type	Description
key	Literal['google/trending']	Plugin discriminator
params	List[GoogleTrendingParameters]	Per-job task entries (1-1000)

GoogleHotelsDetailAsyncPlugin

Bases: BaseModel

Async adapter for the google/hotels/detail plugin

Attributes:

Name	Type	Description
key	Literal['google/hotels/detail']	Plugin discriminator
params	List[GoogleHotelsDetailParameters]	Per-job task entries (1-1000)

GoogleYouTubeAsyncPlugin

Bases: BaseModel

Async adapter for the google/youtube plugin

Attributes:

Name	Type	Description
key	Literal['google/youtube']	Plugin discriminator
params	List[GoogleYouTubeParameters]	Per-job task entries (1-1000)

GooglePlayStoreAsyncPlugin

Bases: BaseModel

Async adapter for the google/play-store plugin

Attributes:

Name	Type	Description
key	Literal['google/play-store']	Plugin discriminator
params	List[GooglePlayStoreParameters]	Per-job task entries (1-1000)

GooglePlayStoreProductAsyncPlugin

Bases: BaseModel

Async adapter for the google/play-store/product plugin

Attributes:

Name	Type	Description
key	Literal['google/play-store/product']	Plugin discriminator
params	List[GooglePlayStoreProductParameters]	Per-job task entries (1-1000)

GooglePlayStoreReviewsAsyncPlugin

Bases: BaseModel

Async adapter for the google/play-store/reviews plugin

Attributes:

Name	Type	Description
key	Literal['google/play-store/reviews']	Plugin discriminator
params	List[GooglePlayStoreReviewsParameters]	Per-job task entries (1-1000)

GoogleShoppingProductAsyncPlugin

Bases: BaseModel

Async adapter for the google/shopping/product plugin

Attributes:

Name	Type	Description
key	Literal['google/shopping/product']	Plugin discriminator
params	List[GoogleShoppingProductParameters]	Per-job task entries (1-1000)

GoogleShoppingProductStoresAsyncPlugin

Bases: BaseModel

Async adapter for the google/shopping/product/stores plugin

Attributes:

Name	Type	Description
key	Literal['google/shopping/product/stores']	Plugin discriminator
params	List[GoogleShoppingProductStoresParameters]	Per-job task entries (1-1000)