# Google Scraper API

> Source: https://scrape.do/documentation/google-scraper-api/

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

The Google Scraper API is a unified suite of nine 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).

> [!NOTE]
> **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](/documentation/async-api/plugins/).

## Sub-APIs

  - [](): } title="Google Search API" href="/documentation/google-scraper-api/search"> SERP results, AI Overviews, AI Mode responses. 150+ languages, 240+ countries, 84 Google domains, strict and contextual filtering.
  - [](): } title="Google Maps API" href="/documentation/google-scraper-api/maps"> Places, place details, paginated user reviews. Rating summaries, popular times, menus, owner responses, third-party hotel sources.
  - [](): } title="Google Shopping API" href="/documentation/google-scraper-api/shopping"> Product listings with prices, retailers, and 18+ filter groups, plus full product pages with every seller offer, variants, and reviews.
  - [](): } title="Google Flights API" href="/documentation/google-scraper-api/flights"> Fares, layovers, durations, airlines, carbon emissions. Multi-airport origin and destination, six sort modes, price insights with history.
  - [](): } title="Google Hotels API" href="/documentation/google-scraper-api/hotels"> Property listings with ratings, hotel class, amenities, GPS, images. Filters for price, rating, brand, eco-cert, free cancellation.
  - [](): } title="Google Play Store API" href="/documentation/google-scraper-api/play-store"> Android app search, product details, and paginated user reviews with developer responses.
  - [](): } title="Google News API" href="/documentation/google-scraper-api/news"> Articles with direct publisher URLs, ISO dates, bylines, thumbnails. Six driver parameters for keyword, topic, story, publisher, or entity navigation.
  - [](): } title="Google Trends API" href="/documentation/google-scraper-api/trends"> Interest over time, by region, related queries, related topics, and real-time trending searches.
  - [](): } title="Gemini Scraper API" href="/documentation/google-scraper-api/gemini"> Send a prompt to Google Gemini and get the Markdown reply, grounding sources, and model label as one JSON response.

---

## 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](/documentation/google-scraper-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](/documentation/google-scraper-api/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](/documentation/google-scraper-api/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:

```json
{
  "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:

```json
{
  "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](/documentation/google-scraper-api/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](/documentation/async-api/plugins/) for the full flow.