# AI Brand Visibility Monitor: ChatGPT and Gemini Share of Voice (`indomitably_doctor/ai-visibility-monitor`) Actor

Track how often ChatGPT, Perplexity and Gemini recommend your brand vs competitors. Get share of voice, mention rank and cited domains per buyer-intent query — GEO analytics for the AI-search era.

- **URL**: https://apify.com/indomitably\_doctor/ai-visibility-monitor.md
- **Developed by:** [Billy DC](https://apify.com/indomitably_doctor) (community)
- **Categories:** AI, SEO tools, Other
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $150.00 / 1,000 query-analyzeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use 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

## AI Brand Visibility Monitor (GEO)

**Measure how often AI assistants recommend your brand — and how often they recommend your competitors instead.**

When people ask ChatGPT, Perplexity, or Gemini *"what's the best CRM for a small business?"*, the answer decides who gets the customer. AI answers are the new search results page, and they increasingly drive purchase decisions — but unlike Google rankings, you can't see them without asking. This Actor asks for you, at scale, and turns the answers into hard numbers: **share of voice, mention rate, mention rank, and cited sources** for your brand vs. your competitors. This practice is known as **GEO (Generative Engine Optimization)** monitoring.

### What it does

1. Takes a list of buyer-intent queries (or auto-generates ~10 from a topic you provide).
2. Asks each query to the AI providers you select:
   - **OpenAI** — `gpt-4o-mini` via the Responses API with web search when available (closest proxy for ChatGPT answers).
   - **Perplexity** — `sonar` model, with native web citations.
   - **Google Gemini** — `gemini-2.0-flash` with Google Search grounding when available.
3. Analyzes every answer:
   - Was your brand mentioned? (case-insensitive, tolerant of plurals and possessives)
   - In what order relative to competitors (mention rank — being named first matters)?
   - How many times was each brand mentioned?
   - Which domains did the AI cite or link? (These are the sources that shape AI answers — your GEO content targets.)
4. Outputs one dataset row per (query, provider) pair, plus an aggregate **SUMMARY** with share of voice per brand, per provider and overall.

Run it on a schedule (Apify Schedules) to track your AI visibility over time and catch when a competitor starts winning the answers.

### Input example

```json
{
    "brandName": "Acme CRM",
    "competitors": ["HubSpot", "Salesforce"],
    "queries": [
        "What is the best CRM for small businesses?",
        "Which CRM should a startup use in 2026?",
        "Affordable HubSpot alternatives?"
    ],
    "providers": ["openai", "perplexity"],
    "maxQueries": 20
}
````

Don't have queries yet? Set `"autoGenerateQueries": true` and `"topic": "CRM software for small businesses"` and the Actor will generate ~10 realistic buyer-intent questions for you.

#### API keys

Provider API keys are resolved in this order:

1. The `apiKeys` input object (stored encrypted): `{"openaiApiKey": "...", "perplexityApiKey": "...", "geminiApiKey": "..."}`
2. Environment variables set on the Actor: `OPENAI_API_KEY`, `PERPLEXITY_API_KEY`, `GEMINI_API_KEY`

You only need keys for the providers you select.

### Output example

One row per (query, provider):

```json
{
    "type": "result",
    "query": "What is the best CRM for small businesses?",
    "provider": "perplexity",
    "brandName": "Acme CRM",
    "brandMentioned": true,
    "brandRank": 2,
    "mentionCounts": { "brand": 1, "competitors": { "HubSpot": 3, "Salesforce": 1 } },
    "citedDomains": ["g2.com", "capterra.com", "hubspot.com"],
    "answerExcerpt": "For small businesses, HubSpot is the most commonly recommended CRM...",
    "timestamp": "2026-07-24T12:00:00.000Z",
    "error": null
}
```

Aggregate summary (also saved to the key-value store as `SUMMARY`):

```json
{
    "type": "summary",
    "overall": {
        "responsesAnalyzed": 6,
        "brands": {
            "Acme CRM":  { "mentions": 3, "shareOfVoicePct": 23.1, "mentionRatePct": 50.0, "avgRank": 2.3 },
            "HubSpot":   { "mentions": 6, "shareOfVoicePct": 46.2, "mentionRatePct": 100.0, "avgRank": 1.2 },
            "Salesforce": { "mentions": 4, "shareOfVoicePct": 30.8, "mentionRatePct": 66.7, "avgRank": 2.0 }
        }
    },
    "perProvider": { "openai": { "...": "..." }, "perplexity": { "...": "..." } }
}
```

- **shareOfVoicePct** — this brand's mentions as a % of all tracked-brand mentions.
- **mentionRatePct** — % of AI answers in which the brand appeared at all.
- **avgRank** — average position among mentioned brands (1 = named first).

### Pricing

This Actor uses **pay-per-event** pricing: you are charged one `query-analyzed` event for each successfully analyzed (query, provider) pair. Failed provider calls are not charged. Example: 20 queries × 2 providers = up to 40 events per run.

> **Note for the Actor owner (publish-time):** define the `query-analyzed` event in the Actor's pay-per-event pricing configuration in Apify Console. If you provide default API keys via environment variables, consider gating free-plan users (e.g., check `Actor.getEnv().userIsPaying` or limit `maxQueries` for free accounts) so LLM costs on free runs stay bounded.

### Honest limitations

- **AI answers are non-deterministic.** The same query can yield different brands on different runs. Treat single runs as samples; schedule recurring runs and watch the trend, not one data point.
- **This queries provider APIs, not the consumer apps.** API answers (especially with web search/grounding enabled) correlate with, but are not identical to, what a user sees in the ChatGPT/Gemini apps.
- **Mention detection is lexical.** It matches brand names (including plurals/possessives) but does not do entity disambiguation — a brand named after a common word (e.g., "Monday") will over-count. Prefer distinctive forms like "Monday.com" in your input.
- **No sentiment analysis.** The Actor measures presence, rank, and counts — not whether the mention was positive.
- **Citations coverage varies.** Perplexity always cites; OpenAI/Gemini only cite when their search tools are available on your API key.

### Local development

```bash
npm install
## Put your input into storage/key_value_stores/default/INPUT.json, then:
npm start
## Or with apify-cli:
apify run
```

Set `"mockMode": true` in the input to smoke-test the full pipeline with deterministic fake answers and no API keys.

# Actor input Schema

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

The brand whose AI visibility you want to measure, e.g. <code>Acme CRM</code>. Matching is case-insensitive and tolerates plurals/possessives.

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

Competitors to benchmark against, e.g. <code>HubSpot</code>, <code>Salesforce</code>.

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

Buyer-intent questions your prospects ask AI assistants, e.g. <code>What is the best CRM for small businesses?</code>. Leave empty and enable auto-generation to have them created from your topic.

## `autoGenerateQueries` (type: `boolean`):

If enabled and no queries are given, ~10 buyer-intent queries are generated from the <b>Topic</b> field using the first available AI provider.

## `topic` (type: `string`):

Used only for query auto-generation, e.g. <code>CRM software for small businesses</code>.

## `providers` (type: `array`):

Which AI assistants to query. Each provider is asked every query.

## `apiKeys` (type: `object`):

Optional object with your own keys: <code>{"openaiApiKey": "...", "perplexityApiKey": "...", "geminiApiKey": "..."}</code>. If omitted, keys configured by the Actor owner are used.

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

Hard cap on how many queries are processed (each query is sent to every selected provider).

## `mockMode` (type: `boolean`):

Skips real API calls and returns deterministic fake answers. For smoke-testing the Actor without API keys.

## Actor input object example

```json
{
  "brandName": "Acme CRM",
  "competitors": [
    "HubSpot",
    "Salesforce"
  ],
  "queries": [
    "What is the best CRM for small businesses?"
  ],
  "autoGenerateQueries": false,
  "providers": [
    "openai"
  ],
  "maxQueries": 20,
  "mockMode": false
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("indomitably_doctor/ai-visibility-monitor").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("indomitably_doctor/ai-visibility-monitor").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call indomitably_doctor/ai-visibility-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=indomitably_doctor/ai-visibility-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "AI Brand Visibility Monitor: ChatGPT and Gemini Share of Voice",
        "description": "Track how often ChatGPT, Perplexity and Gemini recommend your brand vs competitors. Get share of voice, mention rank and cited domains per buyer-intent query — GEO analytics for the AI-search era.",
        "version": "0.1",
        "x-build-id": "TzcgcneR9UuYlnQCP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/indomitably_doctor~ai-visibility-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-indomitably_doctor-ai-visibility-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/indomitably_doctor~ai-visibility-monitor/runs": {
            "post": {
                "operationId": "runs-sync-indomitably_doctor-ai-visibility-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/indomitably_doctor~ai-visibility-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-indomitably_doctor-ai-visibility-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "brandName"
                ],
                "properties": {
                    "brandName": {
                        "title": "Your brand name",
                        "type": "string",
                        "description": "The brand whose AI visibility you want to measure, e.g. <code>Acme CRM</code>. Matching is case-insensitive and tolerates plurals/possessives."
                    },
                    "competitors": {
                        "title": "Competitor brand names",
                        "type": "array",
                        "description": "Competitors to benchmark against, e.g. <code>HubSpot</code>, <code>Salesforce</code>.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "queries": {
                        "title": "Queries to ask the AI models",
                        "type": "array",
                        "description": "Buyer-intent questions your prospects ask AI assistants, e.g. <code>What is the best CRM for small businesses?</code>. Leave empty and enable auto-generation to have them created from your topic.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "autoGenerateQueries": {
                        "title": "Auto-generate queries from topic",
                        "type": "boolean",
                        "description": "If enabled and no queries are given, ~10 buyer-intent queries are generated from the <b>Topic</b> field using the first available AI provider.",
                        "default": false
                    },
                    "topic": {
                        "title": "Topic / product category",
                        "type": "string",
                        "description": "Used only for query auto-generation, e.g. <code>CRM software for small businesses</code>."
                    },
                    "providers": {
                        "title": "AI providers to test",
                        "type": "array",
                        "description": "Which AI assistants to query. Each provider is asked every query.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "openai",
                                "perplexity",
                                "gemini"
                            ],
                            "enumTitles": [
                                "OpenAI (ChatGPT, gpt-4o-mini + web search)",
                                "Perplexity (sonar, with citations)",
                                "Google Gemini (gemini-2.0-flash + Google Search grounding)"
                            ]
                        },
                        "default": [
                            "openai"
                        ]
                    },
                    "apiKeys": {
                        "title": "API keys (optional)",
                        "type": "object",
                        "description": "Optional object with your own keys: <code>{\"openaiApiKey\": \"...\", \"perplexityApiKey\": \"...\", \"geminiApiKey\": \"...\"}</code>. If omitted, keys configured by the Actor owner are used."
                    },
                    "maxQueries": {
                        "title": "Maximum number of queries",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Hard cap on how many queries are processed (each query is sent to every selected provider).",
                        "default": 20
                    },
                    "mockMode": {
                        "title": "Mock mode (testing only)",
                        "type": "boolean",
                        "description": "Skips real API calls and returns deterministic fake answers. For smoke-testing the Actor without API keys.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```