# Google AI Overview Tracker - GEO Citations & Share of Voice (`sonic_scraper/google-ai-overview-tracker`) Actor

Google AI Overview tracker for GEO/AEO: see whether your brand is mentioned and your domain cited, which competitors appear, every cited source, your organic rank and a 0-100 visibility score per query. Citation-gap list included. Uses your SerpApi key.

- **URL**: https://apify.com/sonic_scraper/google-ai-overview-tracker.md
- **Developed by:** [Group Oject](https://apify.com/sonic_scraper) (community)
- **Categories:** SEO tools, AI, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 ai overview results

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 AI Overview Tracker - GEO Citations & Share of Voice

Track whether **your brand and domain appear in Google AI Overviews** - and which competitors do instead. For every keyword or buyer-style prompt you get: does an AI Overview show, is your brand mentioned, is your domain cited, which competitors are mentioned or cited, every cited source, your organic position, a 0-100 visibility score, and a concrete next step. Built for **GEO / AEO** (generative engine optimization / answer engine optimization) reporting.

> **Requires your own SerpApi key** for live data (SerpApi's free plan includes 100 searches per month). Without a key the Actor returns clearly labeled **sample data** so you can preview the output.

### What can this Google AI Overview tracker do?

- **Detect AI Overviews** for each query in your chosen country and language.
- **Brand mention check** - is your brand name in the AI Overview answer text?
- **Citation check** - is your domain one of the cited sources?
- **Competitor tracking** - which competitor brands are mentioned and which competitor domains are cited.
- **Full citation list** - URL, title, domain, and publisher for every source in the AI Overview.
- **Organic context** - your domain's organic position and the top organic results for the same query.
- **Deferred AI Overviews** - when Google loads the AI Overview separately, the Actor fetches the full payload automatically.
- **Visibility score and recommendation** per query, plus run-level summaries: top visible queries, queries where your brand is missing, and the most-cited domains.

### What data can I extract from Google AI Overviews?

| Field | Description |
|---|---|
| `query`, `geo`, `language` | What was searched |
| `aiOverviewPresent` | Whether Google showed an AI Overview |
| `answerText` | The AI Overview answer text |
| `brandName`, `brandMentioned` | Your brand and whether the answer mentions it |
| `domain`, `domainCited`, `domainOrganicPosition` | Your domain, whether it is cited, and its organic rank |
| `competitorsMentioned[]`, `competitorDomainsCited[]` | Competitors present in the answer or citations |
| `citationCount`, `citationDomains[]`, `citationUrls[]` | All sources cited by the AI Overview |
| `visibilityScore` | 0-100 GEO visibility score for this query |
| `recommendation` | What to do next for this query |
| `organicResults[]` | Position, title, link, domain, snippet |
| `warnings[]`, `error`, `fetchedAt`, `source` | Diagnostics |

Key-value store records: `SUMMARY` (AI Overview rate, brand mention count, domain citation count, average visibility, top citation domains), `TOP_VISIBLE_QUERIES`, `CITATION_GAPS` (queries with an AI Overview where neither your brand nor domain appears), and `ERRORS`.

#### How the visibility score works

0 if no AI Overview is shown. Otherwise: 20 base points, +30 if your brand is mentioned, +35 if your domain is cited, +2 to +10 for your organic position (top 3 earns the most), and up to -20 when competitors are mentioned or cited. The formula is fixed and transparent - no AI model is involved.

### How much does it cost?

- **Apify:** $0.003 per query result ($3.00 per 1,000 queries) plus a tiny Actor-start fee.
- **SerpApi:** one search per query, plus one more when the AI Overview must be fetched separately. Billed by SerpApi on your own plan. Leave `noCache` off to benefit from SerpApi's cache.

Check the Pricing tab for current Apify rates.

### How to track AI Overview citations

1. Paste your SerpApi key into **SerpApi key** (stored encrypted, never logged).
2. Add the queries your buyers search - keywords or natural-language prompts.
3. Enter your `brandName`, your `domain`, and competitor names or domains.
4. Choose country and language (AI Overviews are most common for English queries).
5. Click **Start**. Schedule weekly runs to track GEO visibility over time.

### Input example

```json
{
  "queries": ["best ai seo tools", "how to choose a crm for startups"],
  "brandName": "Acme",
  "domain": "acme.com",
  "competitors": ["hubspot.com", "Salesforce"],
  "geo": "US",
  "language": "en",
  "includeOrganicResults": true,
  "fetchAiOverviewDetails": true,
  "serpApiKey": "<YOUR_SERPAPI_KEY>"
}
```

### Output example

```json
{
  "query": "how to choose a crm for startups",
  "aiOverviewPresent": true,
  "brandMentioned": false,
  "domainCited": false,
  "domainOrganicPosition": 7,
  "competitorsMentioned": ["Salesforce"],
  "competitorDomainsCited": ["hubspot.com"],
  "citationCount": 6,
  "citationDomains": ["hubspot.com", "forbes.com", "zapier.com"],
  "visibilityScore": 15,
  "recommendation": "Competitors appear but your brand does not. Build or refresh content that directly answers this prompt."
}
```

Illustrative output shape, not real measurements.

### Use cases

- **GEO / AEO reporting** - share of AI Overview citations for your brand vs competitors.
- **Citation gap analysis** - `CITATION_GAPS` lists queries where an AI Overview appears without you; `citationDomains` shows which sources Google trusts instead.
- **Agency client reports** - weekly AI search visibility per client and keyword set.
- **PR and digital PR targeting** - `citationDomains` shows the publishers Google's AI relies on.
- **SEO impact tracking** - see which of your ranking keywords now sit under an AI Overview.

### Integrations and API

Use the Apify API, schedules, webhooks, Make, Zapier, n8n, Google Sheets, Looker Studio (via CSV/JSON), or the Apify MCP server for AI agents.

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("sonic_scraper/google-ai-overview-tracker").call(run_input={
    "queries": ["best ai seo tools"],
    "brandName": "Acme",
    "domain": "acme.com",
    "competitors": ["semrush.com", "ahrefs.com"],
    "serpApiKey": "<YOUR_SERPAPI_KEY>",
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["query"], row["aiOverviewPresent"], row["domainCited"], row["visibilityScore"])
```

### FAQ

**Does it track Google AI Mode, ChatGPT, or Perplexity?** Not at the moment. This Actor covers Google AI Overviews on the regular Google results page.

**Why is `aiOverviewPresent` false for some queries?** Google only shows AI Overviews for some queries, countries, and languages, and it varies between runs. Track a stable query set over time.

**Why do I need a SerpApi key?** The Actor reads Google results through SerpApi for reliable AI Overview payloads, including deferred ones. Without a key, it returns sample data only.

**Is brand detection case-sensitive?** No. Brand and competitor names are matched case-insensitively in the answer text; domains are matched against citation URLs and organic results.

### Related Actors

- [Google Trends Scraper](https://apify.com/sonic_scraper/trendpulse-keyword-monitor) - find rising queries worth tracking.
- [Google Autocomplete Scraper](https://apify.com/sonic_scraper/google-autocomplete-scraper) - turn a topic into question-style prompts.
- [Technical SEO Audit Crawler](https://apify.com/sonic_scraper/technical-seo-audit-crawler) - fix the pages you want AI Overviews to cite.

# Changelog

This Actor's version history is a separate document: https://apify.com/sonic_scraper/google-ai-overview-tracker/changelog.md

# Actor input Schema

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

Google searches or buyer-style prompts to check for AI Overview visibility.

## `queriesText` (type: `string`):

Paste one query per line or comma-separated.

## `brandName` (type: `string`):

Brand/entity to detect inside the AI Overview answer text.

## `domain` (type: `string`):

Domain to detect in AI Overview citations and organic results, e.g. example.com.

## `competitors` (type: `array`):

Competitor brand names or domains to detect in answers and citations.

## `competitorsText` (type: `string`):

Paste one competitor per line or comma-separated.

## `geo` (type: `string`):

Google country code, e.g. US, GB, CA, FR, DE.

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

Google language code. AI Overviews are most available for English queries.

## `maxQueries` (type: `integer`):

Maximum number of queries to process.

## `includeOrganicResults` (type: `boolean`):

Also include organic Google result positions/domains from SerpApi.

## `fetchAiOverviewDetails` (type: `boolean`):

When Google returns an AI Overview page token, immediately fetch the full AI Overview payload.

## `noCache` (type: `boolean`):

Set true to bypass SerpApi cache. Cached searches can be free on SerpApi, so leave off unless freshness matters.

## `requestDelayMs` (type: `integer`):

Delay between queries.

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

Parallel SerpApi requests. Keep modest to respect your SerpApi limits.

## `serpApiKey` (type: `string`):

Required for live data. Get a free key at https://serpapi.com. Never logged.

## `useMockData` (type: `boolean`):

Use sample data instead of SerpApi. Useful for testing output shape.

## `debugMode` (type: `boolean`):

Verbose logging.

## Actor input object example

```json
{
  "queries": [
    "best ai seo tools",
    "how to choose a crm for startups",
    "best project management software"
  ],
  "brandName": "Example",
  "domain": "example.com",
  "competitors": [
    "competitor.com",
    "Competitor"
  ],
  "geo": "US",
  "language": "en",
  "maxQueries": 100,
  "includeOrganicResults": true,
  "fetchAiOverviewDetails": true,
  "noCache": false,
  "requestDelayMs": 500,
  "maxConcurrency": 3,
  "useMockData": false,
  "debugMode": false
}
```

# Actor output Schema

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

One row per query.

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

Counts, averages, top citation domains, and missing-brand opportunities.

## `citationGaps` (type: `string`):

Queries where AI Overview appears but your brand/domain is missing.

# 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 ai seo tools",
        "how to choose a crm for startups",
        "best project management software"
    ],
    "brandName": "Example",
    "domain": "example.com",
    "competitors": [
        "competitor.com",
        "Competitor"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sonic_scraper/google-ai-overview-tracker").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 ai seo tools",
        "how to choose a crm for startups",
        "best project management software",
    ],
    "brandName": "Example",
    "domain": "example.com",
    "competitors": [
        "competitor.com",
        "Competitor",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("sonic_scraper/google-ai-overview-tracker").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 ai seo tools",
    "how to choose a crm for startups",
    "best project management software"
  ],
  "brandName": "Example",
  "domain": "example.com",
  "competitors": [
    "competitor.com",
    "Competitor"
  ]
}' |
apify call sonic_scraper/google-ai-overview-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sonic_scraper/google-ai-overview-tracker"
        }
    }
}
```

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/wmnoxko6oV4or2Aha/builds/9lDTKI4ZR6RqWRSIA/openapi.json
