# Google Search Data Scraper (`reapx/google-search-data-scraper`) Actor

Keep web search results in the order they appeared for each query. Review titles, snippets, destinations, result types, and rank across searches, with the engine that answered recorded on every row.

- **URL**: https://apify.com/reapx/google-search-data-scraper.md
- **Developed by:** [ReapX](https://apify.com/reapx) (community)
- **Categories:** SEO tools, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 95.8% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.86 / 1,000 search queries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Google Search Data Scraper

Keep web search results in the order they appeared for each query. Review titles, snippets, destinations, result types, and rank across searches, with the engine that answered recorded on every row.

![Google Search Data Scraper source page and returned record](https://reapx.dev/assets/products/google-search-data-scraper/readme.png?v=20260826)

### What it returns

Each row keeps the Google Search source record beside the fields needed to use it. The opening set is `searchTerm`, `rank`, `title`, `url`, `domain`, `snippet`, `resultType`, `countryCode`, `languageCode`, `scrapedAt`, `siteName`, and `source`. The complete schema is declared before the run, and dataset views keep related fields together without changing the underlying row.

#### Captured row

```json
{
  "countryCode": "us",
  "languageCode": "en",
  "rank": 1,
  "resultType": "organic"
}
```

### Input

![Google Search Data Scraper published input controls](https://reapx.dev/assets/products/google-search-data-scraper/schema.png?v=20260826)

![Google Search Data Scraper input-to-run walkthrough](https://reapx.dev/assets/products/google-search-data-scraper/demo.webp?v=20260826)

Google Search Data Scraper accepts searches, source URLs, and result count. Run controls stay in the same form.

| Field | What it controls | Starting value |
| --- | --- | --- |
| `queries` | Enter the search phrases to run, one per line. | `["apify web scraping","b2b lead generation api"]` |
| `startUrls` | Enter Google Search search terms or identifiers, one per line. | `["best crm software","python tutorial","apify web scraping"]` |
| `countryCode` | Enter the two-letter country code used for regional results. | `"us"` |
| `languageCode` | Enter the language code used for source results. | `"en"` |
| `resultsLimit` | Stop after this many dataset rows. | `10` |
| `includePaa` | Keep related questions in the returned record. | `true` |
| `maxSeconds` | Stop after this many seconds and keep completed rows. | `180` |
| `maxConcurrency` | Set the number of source requests that may run in parallel. | `3` |

#### Example input

```json
{
  "queries": [
    "apify web scraping",
    "b2b lead generation api"
  ],
  "startUrls": [
    "best crm software",
    "python tutorial",
    "apify web scraping"
  ],
  "countryCode": "us",
  "languageCode": "en",
  "resultsLimit": 3,
  "includePaa": true,
  "maxSeconds": 180
}
```

No field is required. Start with the filled example, then replace only the target values needed for the job. Run controls can stay at their starting values for the first collection.

### Dataset fields

![Google Search Data Scraper declared output schema](https://reapx.dev/assets/products/google-search-data-scraper/fields.png?v=20260826)

| Field | Type |
| --- | --- |
| `searchTerm` | `string` |
| `rank` | `integer` |
| `title` | `string` |
| `url` | `string` |
| `domain` | `string` |
| `snippet` | `string` |
| `resultType` | `string` |
| `countryCode` | `string` |
| `languageCode` | `string` |
| `scrapedAt` | `string` |
| `siteName` | `string` |
| `source` | `string` |
| `peopleAlsoAsk` | `array:string` |

### Dataset views

Views are working surfaces for review and export. They select and order fields while leaving the stored row unchanged.

| View | Opening fields |
| --- | --- |
| `overview` | `title`, `siteName`, `snippet`, `rank`, `countryCode`, `domain`, `scrapedAt`, and `searchTerm` |
| `identity` | `title` and `siteName` |
| `content` | `title`, `siteName`, `searchTerm`, and `snippet` |
| `engagement` | `title`, `siteName`, `searchTerm`, and `rank` |
| `location` | `title`, `siteName`, `searchTerm`, and `countryCode` |
| `contact` | `title`, `siteName`, `searchTerm`, and `domain` |

### Output and exports

| Output | Type | Destination |
| --- | --- | --- |
| `results` | `string` | `{{links.apiDefaultDatasetUrl}}/items` |
| `json` | `string` | `{{links.apiDefaultDatasetUrl}}/items?clean=true&format=json` |
| `csv` | `string` | `{{links.apiDefaultDatasetUrl}}/items?clean=true&format=csv` |
| `excel` | `string` | `{{links.apiDefaultDatasetUrl}}/items?clean=true&format=xlsx` |
| `jsonl` | `string` | `{{links.apiDefaultDatasetUrl}}/items?clean=true&format=jsonl` |

Completed rows are available in the Apify dataset as JSON, CSV, Excel, and JSONL exports. The run output also carries the declared links above for API clients and automations.

### Pricing

$5 per 1,000 dataset items on the Free plan. Other Apify plans use the rates shown in the Pricing tab.

### Console, API, schedules, and MCP

![Google Search Data Scraper API and MCP invocation](https://reapx.dev/assets/products/google-search-data-scraper/api.png?v=20260826)

Runs can begin in Apify Console, from a saved task, or through the Actor API. A schedule can reuse the same input, and a run-finished webhook can pass the dataset or run ID to the next system.

```text
POST https://api.apify.com/v2/acts/Du5iH9XYIV3CiZj09/runs
GET  https://api.apify.com/v2/datasets/{datasetId}/items
```

For MCP selection, use **Google Search Data Scraper**. Its machine entry carries the same description, input field names, no-required-field contract, output types, dataset fields, views, and pricing facts as this document.

### Saved tasks

Twenty saved-task products cover distinct lookup, comparison, research, operations, automation, and export jobs:

- **Google Search Data rank search term core**: buyer-job; opens `overview`.
- **Google Search Data titles content brief**: buyer-job; opens `identity`.
- **Google Search Data title and copy review**: buyer-job; opens `content`.
- **Google Search Data search term and rank audience sizing**: buyer-job; opens `engagement`.
- **Google Search Data country codes area shortlist**: buyer-job; opens `location`.
- **Google Search Data domain contact reach list**: buyer-job; opens `contact`.
- **Google Search Data search term full record**: buyer-job; opens `overview`.
- **Google Search Data site name and titles description set**: buyer-job; opens `identity`.
- **Google Search Data site name description set**: buyer-job; opens `content`.
- **Google Search Data response site name description set**: buyer-job; opens `engagement`.
- **Google Search Data country codes and site name place routing**: buyer-job; opens `location`.
- **Google Search Data domain site name contact**: buyer-job; opens `contact`.
- **Google Search Data rank and search term detail handoff**: buyer-job; opens `overview`.
- **Google Search Data identity titles reading list**: buyer-job; opens `identity`.
- **Google Search Data snippets and titles reading list**: buyer-job; opens `content`.
- **Google Search Data search term response volume check**: buyer-job; opens `engagement`.
- **Google Search Data location country codes coverage view**: buyer-job; opens `location`.
- **Google Search Data domain contact file**: buyer-job; opens `contact`.
- **Google Search Data core search term detail file**: buyer-job; opens `overview`.
- **Google Search Data site name identity text file**: buyer-job; opens `identity`.

### Integrations

Use the dataset API from any HTTP client, export rows to a spreadsheet, or send the run ID through an Apify webhook. Saved tasks give schedules and automation tools a stable input without changing the Actor contract.

### Related products

- [Google Search Price Scraper](https://apify.com/reapx/google-search-price-scraper)
- [Instagram Search Scraper](https://apify.com/reapx/instagram-search-scraper)
- [Facebook Search Scraper](https://apify.com/reapx/facebook-search-scraper)
- [Reddit Search Scraper](https://apify.com/reapx/reddit-search-scraper)
- [LinkedIn Search Scraper](https://apify.com/reapx/linkedin-search-scraper)

### When a run needs attention

- **No rows:** Open the target in a browser, check spelling and source visibility, then retry the saved example before widening the input.
- **A field is empty:** Check the field beside its source URL. A missing source value stays empty instead of being replaced with a guess.
- **A target fails:** Keep successful targets in the dataset, then retry only the affected input.
- **An automation cannot find results:** Read the dataset ID from the run and request its items endpoint directly.

### FAQ

#### What do I get back from one run?

One row per general with 13 declared fields, opening on searchTerm, rank, title and url. The schema is published before the run, so you know the shape before you spend anything.

#### Do I need a google search account or login?

No. The run works from the google search sources you supply in the input. Nothing is posted, changed or accessed on your behalf.

#### What does a run cost?

The current rate is shown on the Pricing tab and is charged per row you receive, so a run that finds nothing costs close to nothing. Cap the run with the item limit when you want a predictable ceiling.

#### Can I try it before committing budget?

Yes. Cap the run with the item limit in the input and inspect the first rows. The cap is enforced before charging, so a trial run stays a trial.

#### What do I put in the input?

The staged input is already usable: queries, startUrls and countryCode. Replace the staged target with your own list when you are ready to run for real.

#### Are any fields required?

No field is required. Every input carries a working default, so the Actor can be started as-is and refined afterwards.

#### A run returned fewer rows than I expected. Why?

The usual causes are a narrow source list, an item cap still set low, or a source that genuinely holds less than expected. Widen the input or raise the cap and run again.

#### Can I schedule this to run on its own?

Yes. Save the input as an Apify task and attach a schedule. Keep separate tasks when different teams need different targets or delivery paths.

#### Do I need to configure proxies?

No. Network access is handled inside the Actor and needs no proxy configuration from you.

#### How fresh is the data?

Every row is collected during the run you start, not served from a cache. Re-run the same input whenever you need the current state of a google search general.

#### Can I use the results commercially?

The Actor collects publicly accessible google search information. You remain responsible for how you use it, including any privacy or contractual obligations that apply to your business.

#### How do I compare two runs?

Keep searchTerm and rank as your join key and diff the exports. The identity fields stay stable across runs, which is what makes a comparison meaningful.

#### What happens if a source fails mid-run?

The run continues through the remaining sources and finishes with what it collected. Partial results are still written to the dataset rather than discarded.

#### Can I limit how long a run takes?

Yes. The startUrls input caps the run. Use it when you need a predictable cost and a predictable finish time.

#### How do I report a problem?

Open an issue on the Actor with the run ID, the input you used and the field or row that needs attention. The run ID lets the exact execution be inspected.

#### How is this different from Google Search Price Scraper?

Google Search Data Scraper answers one job: Keep a query’s Google results in rank order for comparison.. Google Search Price Scraper covers a different question on the same platform. Run both when you need both sides.

#### What is `source` for?

It records how the row was resolved, so you can filter to the rows you trust instead of treating every row as equally certain.

#### How do I read the output without scrolling through JSON?

Open the overview view on the Output tab. 6 views ship with the Actor (overview, identity, content, engagement, location and contact), each grouping the fields that belong to one question.

#### How do I get the data into my own tools?

Export the dataset as JSON, CSV, Excel or XML, call the dataset API directly, or attach a run-finished webhook and collect the dataset reference as soon as the run ends.

#### Can an agent or LLM call this?

Yes. Google Search Data Scraper is exposed over MCP with the same description, no-required-field input contract and output types shown here, so an agent can select and call it without a human in the loop.

#### Why is a value empty on some rows?

google search does not expose every field on every general. An absent value stays empty rather than being filled with a guess, so a row never invents a fact it did not receive.

### Support

Use the Actor issue form for product questions, broken source routes, schema mismatches, and feedback. Include the smallest input that reproduces the problem. That is enough to locate the run and its dataset without sharing an entire working list.

Use this Actor only for data you are allowed to collect. Follow source terms, privacy law, and your own retention policy.

# Actor input Schema

## `queries` (type: `array`):

Enter the search phrases to run, one per line.

## `startUrls` (type: `array`):

Enter Google Search search terms or identifiers, one per line.

## `countryCode` (type: `string`):

Enter the two-letter country code used for regional results.

## `languageCode` (type: `string`):

Enter the language code used for source results.

## `resultsLimit` (type: `integer`):

Stop after this many dataset rows.

## `includePaa` (type: `boolean`):

Keep related questions in the returned record.

## `maxSeconds` (type: `integer`):

Stop after this many seconds and keep completed rows.

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

Set the number of source requests that may run in parallel.

## Actor input object example

```json
{
  "queries": [
    "apify web scraping",
    "b2b lead generation api"
  ],
  "startUrls": [
    "best crm software",
    "python tutorial",
    "apify web scraping"
  ],
  "countryCode": "us",
  "languageCode": "en",
  "resultsLimit": 10,
  "includePaa": true,
  "maxSeconds": 180,
  "maxConcurrency": 3
}
```

# Actor output Schema

## `results` (type: `string`):

Open all returned Google Search Data Scraper rows with 13 declared fields and 6 working views.

## `json` (type: `string`):

Retrieve clean Google Search Data Scraper records for API, MCP, or webhook use.

## `csv` (type: `string`):

Download the Google Search Data Scraper table for spreadsheets and data tools.

## `excel` (type: `string`):

Open the Google Search Data Scraper rows as an Excel workbook.

## `jsonl` (type: `string`):

Stream one clean Google Search Data Scraper record per line for downstream processing.

# 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 = {
    "queries": [
        "apify web scraping",
        "b2b lead generation api"
    ],
    "startUrls": [
        "best crm software",
        "python tutorial",
        "apify web scraping"
    ],
    "countryCode": "us",
    "languageCode": "en",
    "resultsLimit": 10,
    "includePaa": true,
    "maxSeconds": 180,
    "maxConcurrency": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("reapx/google-search-data-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 = {
    "queries": [
        "apify web scraping",
        "b2b lead generation api",
    ],
    "startUrls": [
        "best crm software",
        "python tutorial",
        "apify web scraping",
    ],
    "countryCode": "us",
    "languageCode": "en",
    "resultsLimit": 10,
    "includePaa": True,
    "maxSeconds": 180,
    "maxConcurrency": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("reapx/google-search-data-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 '{
  "queries": [
    "apify web scraping",
    "b2b lead generation api"
  ],
  "startUrls": [
    "best crm software",
    "python tutorial",
    "apify web scraping"
  ],
  "countryCode": "us",
  "languageCode": "en",
  "resultsLimit": 10,
  "includePaa": true,
  "maxSeconds": 180,
  "maxConcurrency": 3
}' |
apify call reapx/google-search-data-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reapx/google-search-data-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/Du5iH9XYIV3CiZj09/builds/Uhrq803tojRWHDS9b/openapi.json