# Google Search Scraper (`searchapi/google-search-scraper`) Actor

Scrapes organic search results from Google for any query with country, language, and location targeting. Extracts title, URL, snippet, sitelinks, thumbnail, ratings, dates, rich result type, and more.

- **URL**: https://apify.com/searchapi/google-search-scraper.md
- **Developed by:** [Search API](https://apify.com/searchapi) (community)
- **Categories:** SEO tools, Developer tools, Other
- **Stats:** 39 total users, 15 monthly users, 77.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 search results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Search Scraper

### What is this tool?

Google Search Scraper helps you collect search data from Google (the world's most popular search engine). Just type in your search term, and the tool will gather all the websites, articles, and information that Google returns.

### What can you use it for?

- Research on any topic with web search results
- SEO research and content strategy
- Monitor how brands and topics appear in search
- Build datasets and knowledge bases

### What data do you get?

The Actor exposes a stable **54-field output contract**. Organic rows contain only source-backed values, while type-specific rows use dedicated fields such as `summary` and `sources` for cited AI Overviews, `questions` for People Also Ask, and `searches` for related searches.

**Identity** (5 fields): Type, Result Type, Position, Page, Rich Result Type

**URLs**: Result link, URL alias, displayed URL, source domain, favicon, site links, thumbnail, cache link, and search URL

**Text** (6 fields): Title, Title (HTML), Snippet (plain text), Description (alias), Snippet (HTML), Highlighted Terms

**Pricing** (3 fields): Price, Price (numeric), Currency

**Ratings** (3 fields): Rating, Rating Count, Review Count

**Location** (1 fields): Country

**Dates & Duration** (5 fields): Date (raw), Date (raw alias), Published At, Published At (raw), Relative Time

**Categorization** (2 fields): Category, Tags

**Search Context** (5 fields): Search Metadata, Query, Query (alias), Market, Language

**Other**: Breadcrumbs, additional info, PAA questions, related searches, nested-item count, ad/sponsored flags, and scrape timestamp

When Google displays an AI Overview, the Actor emits one `aiOverview` record with the visible summary, linked source titles and URLs, source domains, and source count. It omits the record when the answer or cited external links are absent.

### How to use it

#### Step 1: Enter your search

Type in your search term, like "Elon Musk".

#### Step 2: Set your preferences

Adjust the options below to customize your search.

#### Step 3: Run the tool

Click the run button and wait for your results. The tool will gather all the data and save it in a clean, organized format.

### Input options

| Option | What it means | Required | Default |
|--------|---------------|----------|---------|
| **Search Query** | The search term to use | Yes | Elon Musk |
| **Maximum Items** | Maximum dataset records to retrieve (1–500) | No | 10 |
| **Google Country** | The Google country to use for the query Options: af (Afghanistan), al (Albania), dz (Algeria), as (American Samoa), ad (Andorra), ao (Angola), ai (Anguilla), aq (Antarctica), ag (Antigua and Barbuda), ar (Argentina), am (Armenia), aw (Aruba), ac (Ascension Island), au (Australia), at (Austria), az (... | No | — |
| **UI Language** | The Google UI language to return results Options: af (Afrikaans), ak (Akan), sq (Albanian), am (Amharic), ar (Arabic), hy (Armenian), az (Azerbaijani), eu (Basque), be (Belarusian), bem (Bemba), bn (Bengali), bh (Bihari), bs (Bosnian), br (Breton), bg (Bulgarian), km (Cambodian), ca (Catalan), chr (... | No | — |
| **Language Results** | Limit the results to a specific language Options: lang_ar (Arabic), lang_hy (Armenian), lang_be (Belarusian), lang_bg (Bulgarian), lang_ca (Catalan), lang_zh-cn (Chinese Simplified), lang_zh-tw (Chinese Traditional), lang_hr (Croatian), lang_cs (Czech), lang_da (Danish), lang_nl (Dutch), lang_en (En... | No | — |
| **Country Results** | Limit the results to a specific country Options: af (Afghanistan), al (Albania), dz (Algeria), as (American Samoa), ad (Andorra), ao (Angola), ai (Anguilla), aq (Antarctica), ag (Antigua and Barbuda), ar (Argentina), am (Armenia), aw (Aruba), ac (Ascension Island), au (Australia), at (Austria), az (... | No | — |
| **Time Period** | Time period for results | No | — |
| **Custom Time Period Min** | Minimum date for custom time period (MM/DD/YYYY) | No | — |
| **Custom Time Period Max** | Max date for custom time period (MM/DD/YYYY) | No | — |
| **No Autocorrect** | Exclude results from auto-corrected queries (0 or 1) | No | — |
| **Filter** | Enable/disable Similar Results and Omitted Results filters (0 or 1) | No | — |
| **Maximum concurrency** | Parallel browser requests (1–5) | No | 2 |
| **Maximum request retries** | Retries for temporary failures (0–5) | No | 1 |
| **Navigation timeout** | Browser navigation timeout in seconds (10–120) | No | 45 |
| **Request handler timeout** | Per-page handler timeout in seconds (30–300) | No | 120 |
| **Proxy configuration** | Apify Proxy or user-provided proxy settings; GOOGLE_SERP is recommended on Apify Cloud | No | Apify Proxy |

### Output

Your results come in a clean, organized table with **two views**:

#### Overview view

Shows the most important fields at a glance:

- **Query**
- **Position**
- **Title**
- **Displayed URL**
- **Domain**
- **Rating**
- **Rating Count**
- **Date (raw)**
- **Country**
- **Language**
- **Scraped At**

#### Full details view

Shows all 54 documented fields in detail. Fields with no source value are omitted rather than stored as null or empty placeholders.

### Tips for best results

✅ **Be specific** with your search terms for more relevant results

✅ **Try different variations** of your search term to discover more results

✅ **Browse multiple pages** of results to get a wider variety

### Frequently asked questions

**Why use Google?**
Google is the world's most popular search engine, handling over 8 billion searches per day. It has the largest index of web pages and provides the most comprehensive search results.

**How do I get the results?**
Your results are saved in your Apify dashboard. You can download them in various formats (JSON, CSV, Excel) or access them via the API.

**Can I run it on a schedule?**
Yes! Apify supports scheduled runs. You can set up the tool to run automatically at any interval (hourly, daily, weekly, etc.) from your dashboard.

**What if I get fewer results than I asked for?**
This can happen if the search engine doesn't have enough matching results for your search, or if some results are blocked. Try different keywords or relax your filters.

**Need more help?**
If you have questions or run into issues, our support team is ready to help. Just reach out through the Apify platform and we'll get back to you quickly.

# Changelog

This Actor's version history is a separate document: https://apify.com/searchapi/google-search-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

The search term to use

## `maxItems` (type: `integer`):

Maximum number of search results to retrieve

## `gl` (type: `string`):

The Google country to use for the query

## `hl` (type: `string`):

The Google UI language to return results

## `lr` (type: `string`):

Limit the results to a specific language

## `cr` (type: `string`):

Limit the results to a specific country

## `time_period` (type: `string`):

Time period for results

## `time_period_min` (type: `string`):

Minimum date for custom time period (MM/DD/YYYY)

## `time_period_max` (type: `string`):

Maximum date for custom time period (MM/DD/YYYY)

## `nfpr` (type: `integer`):

Exclude results from auto-corrected queries (0 or 1)

## `filter` (type: `integer`):

Enable/disable Similar Results and Omitted Results filters (0 or 1)

## `maxConcurrency` (type: `integer`):

Maximum Google result pages processed concurrently.

## `maxRequestRetries` (type: `integer`):

Retries for temporary network, proxy, rate-limit, and server failures. CAPTCHA pages fail immediately.

## `navigationTimeoutSecs` (type: `integer`):

Maximum browser navigation time per page.

## `requestHandlerTimeoutSecs` (type: `integer`):

Maximum extraction time per result page.

## `proxyConfiguration` (type: `object`):

Proxy config. Use GOOGLE_SERP group for best CAPTCHA bypass on Google.

## Actor input object example

```json
{
  "query": "Elon Musk",
  "maxItems": 10,
  "maxConcurrency": 2,
  "maxRequestRetries": 1,
  "navigationTimeoutSecs": 45,
  "requestHandlerTimeoutSecs": 120,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "Elon Musk",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("searchapi/google-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "Elon Musk",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("searchapi/google-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "Elon Musk",
  "maxItems": 10
}' |
apify call searchapi/google-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,searchapi/google-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/a5xHre6mpml6zYqN7/builds/p2fPuXOCl6jfLQX3j/openapi.json