Google Scraper API

A unified suite of Google scraping APIs covering Search, Maps, Shopping, Flights, Hotels, News, and Trends, all returning structured JSON

The Google Scraper API is a unified suite of seven specialized plugins covering Google's biggest data surfaces. Each sub-API returns parsed, structured JSON, with no HTML parsing, no JavaScript rendering, and no protobuf decoding. They share authentication, share localization parameters, and chain identifiers cleanly across products (a place_id from Search to Maps Place to Maps Reviews; a topic_token from News across drivers; a data_id between Maps endpoints).

Credit Usage: Most endpoints cost 10 credits per request. Single-credit exceptions are noted on each sub-API's page. For bulk processing, every endpoint is also available through the Async API with plugins.

Sub-APIs

Google Search API

SERP results, AI Overviews, AI Mode responses. 150+ languages, 240+ countries, 84 Google domains, strict and contextual filtering.

Google Maps API

Places, place details, paginated user reviews. Rating summaries, popular times, menus, owner responses, third-party hotel sources.

Google Shopping API

Up to 40 products per page with prices, retailers, ratings, delivery info. 18+ filter groups, categorized result clusters, currency localization.

Google Flights API

Fares, layovers, durations, airlines, carbon emissions. Multi-airport origin and destination, six sort modes, price insights with history.

Google Hotels API

Property listings with ratings, hotel class, amenities, GPS, images. Filters for price, rating, brand, eco-cert, free cancellation.

Google News API

Articles with direct publisher URLs, ISO dates, bylines, thumbnails. Six driver parameters for keyword, topic, story, publisher, or entity navigation.

Google Trends API

Interest over time, by region, related queries, related topics, and real-time trending searches.

Shared References

Every sub-API uses the same localization vocabulary (hl, gl, google_domain) and shares the same transient-error semantics. Consolidated reference pages cover the full code lists once instead of repeating them per sub-API.

Localization

Complete hl (150+ languages), gl (240+ countries), google_domain (84 domains), lr / cr strict filters, location / uule, ll, device, time_period. Applicable-to badges per parameter.

Currency

currency codes used by Flights, Hotels, and Shopping. Independent of gl, so you can request EUR pricing from a US perspective for unified multi-region comparison.

Transient Errors

Why 502 no results happens, when to retry, and the retry-once pattern that recovers ~99% of transient empties.

Authentication

All requests use your Scrape.do API token via the token query parameter:

https://api.scrape.do/plugin/google/<endpoint>?token=YOUR_TOKEN&...

Common Response Shape

Every Google plugin returns JSON with the same broad structure:

{
  "search_parameters": { ... },     // echo of request parameters
  "search_information": { ... },    // metadata (where applicable)
  "<results_key>": [ ... ],         // local_results, shopping_results, news_results, properties, best_flights, ...
  "pagination": { ... }             // when applicable
}

Array fields always return [] when empty (never null). Object fields return null when absent.

Error Handling

Every endpoint returns errors in a consistent JSON format:

{
  "error": "error_code",
  "message": "Human readable error message"
}

400 responses indicate a client error (missing or invalid parameter). 502 responses indicate a transient upstream failure. See Transient Errors for retry guidance. 500 responses indicate a parser-level issue and are usually transient.

Async Bulk Processing

Every Google plugin endpoint is also available as an async plugin via the Async API. Submit batches of requests and collect results as they complete. See Async API with plugins for the full flow.