# Google Search Scraper: SERP, AI Overview & AI Mode (`earlytern/google-search-ai-overview-scraper`) Actor

Google results with AI Overview and AI Mode answers: organic results, ads, People Also Ask, cited sources, and your domain's rank and AI citations. From $2.50 per 1,000 pages.

- **URL**: https://apify.com/earlytern/google-search-ai-overview-scraper.md
- **Developed by:** [earlytern](https://apify.com/earlytern) (community)
- **Categories:** SEO tools, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 search results pages

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?

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: SERP, AI Overview & AI Mode

Get **Google search results** for up to 10,000 queries per run, with the **AI Overview** Google shows above the results
and, if you want, the **Google AI Mode answer**: organic results, ads, People Also Ask questions, related searches, and
every source the AI answers cite. Add your website and each row tells you **your rank** and whether Google's AI answers
**cite you**. Any country or city, any language, desktop or mobile. No Google account and no proxies to manage.

### What does Google Search Scraper do?

- **Full results page**: organic results (position, title, address, website, description) up to 100 per query, ads,
  People Also Ask questions and related searches.
- **AI Overview included**: its text, its formatted version with links, and the pages it cites. No extra charge.
- **AI Mode answers**: turn on **Include AI Mode answer** to also get Google AI Mode's answer and its cited pages.
- **Rank tracking that still works**: Google now hides most result links behind its own `google.com/goto` redirect.
  Each result still gets its real website in `domain`, so your rank is found.
- **Track your domain**: `trackedDomainRank`, `trackedDomainInAiOverview` and `trackedDomainInAiMode` on every row,
  and `isTrackedDomain` on each result and cited page. Subdomains count.
- **Any location**: a country (`Germany`) or a city (`London,England,United Kingdom`), in any language Google offers.
- **One row per query**, ready for a spreadsheet or a dashboard.
- **Fair billing**: queries without results, rejected, skipped and failed queries are free.

### Who uses it?

- **Brands and SEO teams**: check whether Google's AI Overview and AI Mode cite your site for the searches that matter,
  and how that changes week to week.
- **Agencies**: rank tracking and AI citation reports for many clients and countries in one run.
- **Content teams**: read People Also Ask and the AI Overview to see what searchers want answered.
- **PPC managers**: see which advertisers bid on your keywords.
- **Researchers and developers**: feed Google results and AI answers into dashboards, spreadsheets and AI agents.

### How to use it

1. Click **Try for free**.
2. In **Search queries**, add one query per line, for example `best running shoes`.
3. Set **Location** (default: United States) and **Language** (default: `en`).
4. Choose **Results per query** (10 to 100). Every 10 results are one result page.
5. Optional: turn on **Include AI Mode answer**, and put your website in **Track a domain**.
6. Click **Start**. Download the results as JSON, CSV or Excel.

Runs of up to 10 queries usually finish within a few minutes. Larger runs wait for Google results in a queue and take
a few minutes more: give them a timeout of at least 10 minutes in Run options (the run tells you if it is shorter).

### Use with AI agents (MCP)

AI assistants and AI agents can call this Actor through Apify's MCP server at [mcp.apify.com](https://mcp.apify.com).
Questions it answers well:

- "Does Google's AI Overview cite example.com for 'best crm for startups'?" Set **Track a domain** and read
  `trackedDomainInAiOverview`.
- "Where does my site rank in Germany for these 20 queries?" Set **Location** to `Germany` and read
  `trackedDomainRank`.
- "What does Google AI Mode say about this product, and which sources does it use?" Turn on AI Mode and read
  `aiMode.markdown` and `aiMode.references`.

Only `queries` is needed.

### Input example

```json
{
  "queries": ["best running shoes", "trail running shoes for beginners"],
  "location": "United States",
  "language": "en",
  "device": "desktop",
  "resultsPerQuery": 10,
  "includeAiOverview": true,
  "aiMode": true,
  "trackDomain": "example.com"
}
```

### Output example

```json
{
  "query": "best running shoes",
  "type": "serp",
  "status": "ok",
  "message": null,
  "location": "United States",
  "language": "en",
  "device": "desktop",
  "resultsPerQuery": 10,
  "organicResults": [
    { "position": 1, "title": "The 10 Best Running Shoes", "url": "https://www.example.com/best-running-shoes", "domain": "www.example.com", "description": "We tested 60 pairs…", "isTrackedDomain": true }
  ],
  "ads": [{ "position": 1, "title": "Running Shoes Sale", "url": "https://shop.example.org/", "domain": "shop.example.org", "description": "Free delivery…" }],
  "peopleAlsoAsk": ["What is the number 1 running shoe?"],
  "relatedSearches": ["best running shoes for women"],
  "aiOverview": {
    "text": "The best running shoes depend on your stride and the surface you run on…",
    "markdown": "The best running shoes depend on **your stride**…",
    "references": [{ "title": "The 10 Best Running Shoes", "url": "https://www.example.com/best-running-shoes", "domain": "www.example.com", "source": "Example", "isTrackedDomain": true }]
  },
  "aiMode": {
    "text": "For most runners, a cushioned daily trainer is the safest choice…",
    "markdown": "For most runners, a **cushioned daily trainer**…",
    "references": [{ "title": "Running shoe guide", "url": "https://www.example.net/guide", "domain": "www.example.net", "source": "Example Net", "isTrackedDomain": false }]
  },
  "trackDomain": "example.com",
  "trackedDomainRank": 1,
  "trackedDomainInAiOverview": true,
  "trackedDomainInAiMode": false,
  "resultsCount": 1250000000,
  "checkUrl": "https://www.google.com/search?q=best+running+shoes&hl=en&gl=US",
  "scrapedAt": "2026-11-16T10:00:00.000Z"
}
```

| Field | What it is |
|---|---|
| `query` | Your search query |
| `status` | `ok`, `no_results`, `invalid`, `skipped` or `error` (see below) |
| `message` | Why a query was not searched or failed, or a note about part of the answer |
| `location`, `language`, `device`, `resultsPerQuery` | What was searched |
| `organicResults` | Organic results in Google's order: `position`, `title`, `url`, `domain`, `description`, `isTrackedDomain` |
| `ads` | Ads: `position`, `title`, `url`, `domain`, `description` |
| `peopleAlsoAsk` | People Also Ask questions |
| `relatedSearches` | Related searches |
| `aiOverview` | AI Overview: `text`, `markdown`, `references` (`title`, `url`, `domain`, `source`, `isTrackedDomain`); empty when Google shows none |
| `aiMode` | AI Mode answer, same fields; empty when AI Mode is off or gave no answer |
| `trackDomain` | Your tracked domain |
| `trackedDomainRank` | Position of your first organic result; empty when you are not in the results collected |
| `trackedDomainInAiOverview` | Whether the AI Overview cites your domain |
| `trackedDomainInAiMode` | Whether the AI Mode answer cites your domain |
| `resultsCount` | About how many results Google says it has |
| `checkUrl` | Link to the same Google results page |
| `scrapedAt` | When the query was searched |

| Status | Meaning | Charged |
|---|---|---|
| `ok` | Google answered | Yes |
| `no_results` | Google showed no results for the query | No |
| `invalid` | Not searched: the query is longer than 700 characters | No |
| `skipped` | Not searched: the run reached your maximum cost per run, the Free plan trial limit, or the most one run can search (split the list into smaller runs) | No |
| `error` | The search failed or was not ready before the run's time limit (`message` says which) | No |

The **OUTPUT** record of each run sums up the counts and why a run stopped early.

### How much does it cost?

You pay for each **result page** of a query Google answers (10 results per page, AI Overview included), and for each
**AI Mode answer** when AI Mode is on. No start fee. Prices per 1,000 by Apify plan:

| Event, per 1,000 | Free | Bronze | Silver | Gold and up |
|---|---|---|---|---|
| Search results page (10 results, AI Overview included) | $3.50 | $3.00 | $2.75 | $2.50 |
| AI Mode answer | $15.00 | $4.50 | $2.90 | $2.50 |

- Queries with `site:`, `intitle:`, `inurl:`, `intext:`, `filetype:` and similar search operators count as **5 pages**
  for every 10 results.
- **Free**: queries without results, rejected, skipped and failed queries; AI Mode answers that did not come back.
- Set a **maximum cost per run** and the Actor plans the run to stay under it. Queries it could not pay for are listed
  as `skipped`, free.

Examples on Bronze:

- **100 queries**, 10 results each, with AI Overview: 100 × $0.003 = **$0.30**.
- **100 queries**, 100 results each: 100 × 10 pages × $0.003 = **$3.00**.
- **100 queries** with AI Mode: $0.30 + 100 × $0.0045 = **$0.75**.

**Apify Free plan**: each run searches up to 10 queries (6 with AI Mode, 2 with `site:` and similar operators), first
page only (10 results), then stops and says so. The other queries are listed as `skipped`, free. Any paid Apify plan
searches the full list.

### FAQ

**Is there always an AI Overview?** No. Google shows an AI Overview for some searches only, and less often in some
countries and languages. When it shows none, `aiOverview` is empty and you pay the same page price.

**Why is AI Mode empty for my query?** AI Mode is not offered in every country and language, and does not answer every
query. Rows without an AI Mode answer are not charged for it; `message` says what happened.

**Why is `trackedDomainRank` empty?** Your site is not among the results collected. Raise **Results per query** to look
further down.

**Why does a result link start with `google.com/goto`?** Google now shows most result links that way, and the real
address is not in the page. The link still opens the page, and `domain` is the website Google shows under the result.
The pages cited by AI Overview and AI Mode keep their real addresses.

**How fresh are the results?** Each query is searched on Google when the run runs.

**Which locations work?** Countries by name (`Germany`) and cities as `City,Region,Country`
(`Austin,Texas,United States`). If a location is not recognized, the row says so and is not charged.

### Limits

- Up to 10,000 queries per run, each up to 700 characters; duplicates (any case) are removed.
- 10 to 100 results per query, in steps of 10.
- Runs of more than 10 queries need a timeout of at least 10 minutes.

### Related

- [Keyword Search Volume & CPC](https://apify.com/earlytern/keyword-search-volume): Google search volume and CPC for
  your queries.
- [SEO Site Audit & Broken Link Checker](https://apify.com/earlytern/seo-site-audit): technical SEO audit of every
  page of a website.

### Questions and feedback

Open an issue on the **Issues** tab.

# Actor input Schema

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

What to search on Google, one query per line, up to 10,000 per run. Search operators such as site: work; queries with site:, intitle:, inurl: and similar operators count as 5 result pages each.

## `location` (type: `string`):

Country, or City,Region,Country, as Google lists it: United States, Germany, London,England,United Kingdom.

## `language` (type: `string`):

Language code (en, de, pt-BR) or name (English).

## `device` (type: `string`):

Results as Google shows them on a computer or on a phone.

## `resultsPerQuery` (type: `integer`):

Organic results to collect for each query, 10 to 100. Every 10 results are one result page.

## `includeAiOverview` (type: `boolean`):

Collect the AI Overview Google shows above the results, with its text and cited sources. No extra charge.

## `aiMode` (type: `boolean`):

Also ask Google AI Mode each query and collect its answer and cited sources. Charged per AI Mode answer. AI Mode is not offered in every country and language.

## `trackDomain` (type: `string`):

Your website, such as example.com. Each row then shows its rank in the organic results and whether the AI Overview and AI Mode answer cite it. Subdomains count.

## Actor input object example

```json
{
  "queries": [
    "best running shoes"
  ],
  "location": "United States",
  "language": "en",
  "device": "desktop",
  "resultsPerQuery": 10,
  "includeAiOverview": true,
  "aiMode": false
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

No description

# 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": [
        "best running shoes"
    ],
    "resultsPerQuery": 10,
    "includeAiOverview": true,
    "aiMode": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("earlytern/google-search-ai-overview-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": ["best running shoes"],
    "resultsPerQuery": 10,
    "includeAiOverview": True,
    "aiMode": False,
}

# Run the Actor and wait for it to finish
run = client.actor("earlytern/google-search-ai-overview-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": [
    "best running shoes"
  ],
  "resultsPerQuery": 10,
  "includeAiOverview": true,
  "aiMode": false
}' |
apify call earlytern/google-search-ai-overview-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,earlytern/google-search-ai-overview-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/dm1n6IFQM1n42o3eK/builds/NvEdKWnnvDrNps6Ap/openapi.json
