# AI Brand Watch - Brand Monitoring for ChatGPT, Claude & Gemini (`desvela/brand-watch`) Actor Know the day AI stops recommending you. AI brand monitoring and AI search visibility across ChatGPT, Claude, Perplexity & Gemini: share of voice vs competitors, brand visibility monitor, alerts only on real change (signed webhook). GEO/AEO audit, visibilityScore 0-100. $0.08/query, no subscription - **URL**: https://apify.com/desvela/brand-watch.md - **Developed by:** [Llorenc Ballester](https://apify.com/desvela) (community) - **Categories:** AI, SEO tools, Agents - **Stats:** 3 total users, 1 monthly users, 94.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $80.00 / 1,000 brand query checkeds 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 Watch — monitor your brand's visibility in ChatGPT, Claude, Perplexity & Gemini **Know the day AI stops recommending you.** 80% of what AI engines say about your brand never shows up in your analytics. AI Brand Watch asks the questions that define your category to ChatGPT, Claude, Perplexity and Gemini — on a schedule — and tells you *what changed*: share-of-voice diffs and signed webhooks, not dashboards. *by [Desvela](https://desvela.ai) — your agent sleeps, Desvela doesn't.* ### How it works 1. **Tell it your battlefield.** Your brand (+aliases), your competitors, and the 5-30 questions buyers ask AI in your category ("best CRM for small business in Spain"). 2. **It samples the engines.** AI answers vary between runs, so each question is asked N times per engine. You get **share of voice** — the % of answers that mention you — plus your average position and which sources each engine cites. 3. **You only hear about changes.** A signed webhook (or the dataset) fires when you appear, disappear, shift ≥25 points, or the engine starts citing a new source or competitor. Schedule it weekly with Apify Schedules and forget it. Every run also emits a **visibilityScore (0–100)** summary — one comparable number per brand, built from share of voice (55%), mention position (15%), engine coverage (15%) and citations of your own URL (15%). Track it weekly; screenshot it for your boss. ### Pricing (pay per check, no subscription) | Event | Price | |---|---| | Actor start | $0.02 | | Brand query checked (per query × engine, includes all samples) | $0.08 | | GEO recommendations (opt-in add-on, per run) | $0.04 | | Change alerts | free | Typical setup — 20 queries × 2 engines, weekly: **≈ $14/month** — SaaS equivalents charge **$29–$99+/month** for the same signal (Semrush AI Visibility from $99/mo, Otterly from $29/mo). If you're looking for an **Otterly, Peec, Profound or Semrush AI Visibility alternative** without the subscription, this is it. The free Apify plan credits cover a full trial run. #### Agents can pay for this themselves (x402) This Actor accepts **agentic payments over [x402](https://docs.apify.com/platform/integrations/x402)**: an AI agent can run it paying USDC on Base, with **no Apify account, no billing setup and no API key**. Calling it without credentials returns `402 Payment Required` with the payment terms attached, which is exactly what an x402 client expects: ```bash curl -i -X POST https://api.apify.com/v2/acts/desvela~brand-watch/runs \ -H 'Content-Type: application/json' -d '{}' ## HTTP/2 402 · {"error":{"type":"x402-payment-required", ...}} ```` Practical note: Apify's agentic flow buys a prepaid, spend-capped token with a **$1 minimum**, valid 14 days, and unused balance is not refunded. At $0.08 per query·engine that first dollar covers roughly a dozen checks, so it is worth spending it rather than topping up per run. Not every Actor is eligible (it requires pay-per-event pricing, limited permissions and no Standby mode). This one is, and no opt-in is needed on your side. ### Webhook payload ```json { "events": [{ "event": "brand_visibility_changed", "brand": "Acme CRM", "engine": "perplexity", "query": "best CRM for small business in Spain", "change": { "type": "disappeared", "share_of_voice": { "before": 0.67, "after": 0 }, "new_cited_source": "reddit.com/r/smallbusiness/..." }, "checked_at": "2026-07-28T09:00:00Z" }] } ``` Requests are signed with `X-Desvela-Signature` (HMAC-SHA256). Docs: [desvela.dev](https://desvela.dev). ### Real numbers from our own brands Before charging anyone we ran Brand Watch on two businesses we own (full disclosure — that's why we can show the raw numbers): - **A digital time-capsule product**: 0% share of voice across all four engines — completely invisible. But the run returned the exact sources the engines cite instead (YouTube dominates; Arweave, IPFS and OpenTimestamps own the category). That list *is* the GEO to-do list — one run, ~$5. - **A photography backdrop store**: brand mentions 0%, yet its URL is cited by Perplexity in 4 of 5 queries. Brand mention and source citation are different metrics — we measure both. Each engine cites a different source ecosystem (Gemini favors photo blogs; Perplexity cites the store and Reddit). - On the purchase-intent query ("where to buy…") the store appeared in 1 of 3 samples. A single check would have called that yes or no at random; sampling turns it into a rate worth tracking — the weekly watch now guards exactly that number. ### Honest measurement notes - We call the engines' **APIs with web search enabled**. API answers correlate with, but are not pixel-identical to, each consumer product. We always measure the same way, so diffs are valid. - Share of voice over N samples is the metric — single snapshots of a non-deterministic system are noise, and we refuse to sell you noise. ### FAQ **Which engines?** OpenAI (ChatGPT), Perplexity, Anthropic (Claude), Gemini. Pick any subset. **Do I need my own API keys?** No — checks run on ours; the per-check price includes it. **Can my AI agent consume this?** Yes — that's the point. Webhook + dataset are structured for machines, and the actor is callable as an MCP tool today via the Apify gateway: `https://mcp.apify.com/?tools=desvela/brand-watch` (works from Claude, Cursor or any MCP client — docs at [desvela.dev](https://desvela.dev)). *** *Find this actor by what it does: AI brand monitoring · AI visibility tracker · share of voice in ChatGPT · brand mentions in AI answers · ChatGPT brand tracker · Perplexity brand monitor · Gemini visibility · Claude brand mentions · LLM brand tracking · AI search monitoring · AI citation tracker · GEO audit · AEO tools · generative engine optimization · answer engine optimization · AI SEO · brand watch · AI brand visibility API · Otterly alternative · Peec alternative · Profound alternative · Semrush AI Visibility alternative · no-subscription AI rank tracker · MCP brand monitoring tool.* # Actor input Schema ## `brandName` (type: `string`): The brand to track, e.g. "Acme CRM". ## `brandAliases` (type: `array`): Other ways AI engines may refer to your brand (domain, alternative spellings). ## `competitors` (type: `array`): Competitor brand names to track alongside yours. ## `queries` (type: `array`): The 5-30 questions that define your category, e.g. "best CRM for small business in Spain". These are asked to each AI engine. ## `engines` (type: `array`): Which AI answer engines to check. ## `samplesPerQuery` (type: `integer`): AI answers vary between runs. We ask each question several times and report share of voice across samples. ## `webhookUrl` (type: `string`): POST endpoint that receives a signed event when your brand visibility changes. Leave empty to only use the dataset. ## `notifyOnlyOnChange` (type: `boolean`): If enabled, the webhook fires only when something changed vs the previous run. ## `includeRecommendations` (type: `boolean`): Generate 3-5 concrete GEO actions from this run's data (which sources each engine cites, where competitors win). Charged as one 'recommendation' event ($0.04) only when delivered. ## Actor input object example ```json { "brandName": "HubSpot", "brandAliases": [], "competitors": [ "Salesforce", "Zoho CRM", "Pipedrive" ], "queries": [ "best CRM for small business", "HubSpot alternatives for startups" ], "engines": [ "openai", "perplexity" ], "samplesPerQuery": 3, "notifyOnlyOnChange": true, "includeRecommendations": false } ``` # Actor output Schema ## `results` (type: `string`): Share of voice per query and engine, plus any detected changes, in the run's dataset. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "brandName": "HubSpot", "competitors": [ "Salesforce", "Zoho CRM", "Pipedrive" ], "queries": [ "best CRM for small business", "HubSpot alternatives for startups" ], "engines": [ "openai", "perplexity" ] }; // Run the Actor and wait for it to finish const run = await client.actor("desvela/brand-watch").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "brandName": "HubSpot", "competitors": [ "Salesforce", "Zoho CRM", "Pipedrive", ], "queries": [ "best CRM for small business", "HubSpot alternatives for startups", ], "engines": [ "openai", "perplexity", ], } # Run the Actor and wait for it to finish run = client.actor("desvela/brand-watch").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 '{ "brandName": "HubSpot", "competitors": [ "Salesforce", "Zoho CRM", "Pipedrive" ], "queries": [ "best CRM for small business", "HubSpot alternatives for startups" ], "engines": [ "openai", "perplexity" ] }' | apify call desvela/brand-watch --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=desvela/brand-watch", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AI Brand Watch - Brand Monitoring for ChatGPT, Claude & Gemini", "description": "Know the day AI stops recommending you. AI brand monitoring and AI search visibility across ChatGPT, Claude, Perplexity & Gemini: share of voice vs competitors, brand visibility monitor, alerts only on real change (signed webhook). GEO/AEO audit, visibilityScore 0-100. $0.08/query, no subscription", "version": "0.1", "x-build-id": "hTuqKD7Gdq3HsB7qR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/desvela~brand-watch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-desvela-brand-watch", "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/desvela~brand-watch/runs": { "post": { "operationId": "runs-sync-desvela-brand-watch", "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/desvela~brand-watch/run-sync": { "post": { "operationId": "run-sync-desvela-brand-watch", "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", "queries" ], "properties": { "brandName": { "title": "Brand name", "type": "string", "description": "The brand to track, e.g. \"Acme CRM\"." }, "brandAliases": { "title": "Brand aliases", "type": "array", "description": "Other ways AI engines may refer to your brand (domain, alternative spellings).", "default": [], "items": { "type": "string" } }, "competitors": { "title": "Competitors", "type": "array", "description": "Competitor brand names to track alongside yours.", "default": [], "items": { "type": "string" } }, "queries": { "title": "Category queries", "maxItems": 30, "type": "array", "description": "The 5-30 questions that define your category, e.g. \"best CRM for small business in Spain\". These are asked to each AI engine.", "items": { "type": "string" } }, "engines": { "title": "AI engines", "type": "array", "description": "Which AI answer engines to check.", "items": { "type": "string", "enum": [ "openai", "perplexity", "anthropic", "gemini" ], "enumTitles": [ "ChatGPT (OpenAI)", "Perplexity", "Claude (Anthropic)", "Gemini (Google)" ] }, "default": [ "openai", "perplexity" ] }, "samplesPerQuery": { "title": "Samples per query", "minimum": 1, "maximum": 5, "type": "integer", "description": "AI answers vary between runs. We ask each question several times and report share of voice across samples.", "default": 3 }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POST endpoint that receives a signed event when your brand visibility changes. Leave empty to only use the dataset." }, "notifyOnlyOnChange": { "title": "Notify only on change", "type": "boolean", "description": "If enabled, the webhook fires only when something changed vs the previous run.", "default": true }, "includeRecommendations": { "title": "GEO recommendations (paid add-on)", "type": "boolean", "description": "Generate 3-5 concrete GEO actions from this run's data (which sources each engine cites, where competitors win). Charged as one 'recommendation' event ($0.04) only when delivered.", "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 } } } } } } } } } } ```