AI Search Visibility Tracker: ChatGPT, Perplexity & Gemini
Pricing
from $6.50 / 1,000 prompt sampled — google ai overviews
AI brand monitoring across ChatGPT, Perplexity, Gemini and Google AI Overviews. Samples every prompt multiple times for mention rate, share of voice and week-over-week deltas — not a single-shot guess.
All notable changes to this Actor are documented here. The format follows Keep a Changelog .
Documentation correction. No code change.
The 0.4.3 notes claimed Apify has no multi-example mechanism and that the
competitors' "examples" were README content. Both were wrong. The claim came
from a page fetch whose markdown conversion dropped the tab bar; the raw HTML
shows an Examples tab on apify/google-search-scraper and on the competitor,
and none on ours.
The real mechanism: the Examples tab is backed by Apify Tasks. A task
appears there once publicConfig.publishedAt is set. Creating tasks is
API-writable and is now done — four exist, one per entry in
.actor/examples.json. Setting publicConfig is not: the API accepts it and
stores null, and no publish route exists in the OpenAPI spec, so publishing
is a Console step. exampleRunInput is a separate, older field that prefills
the Input tab rather than the Examples tab.
Corrected in .actor/examples.json, OPERATIONS.md and the 0.4.3 entry, with
the four task IDs and the exact Console path recorded.
Ready-to-run examples. Listing content only.
.actor/examples.json — four input examples, one per differentiator: the full
audit, a cheap Google-AI-Overviews-only weekly watch, a genuinely localized
French run, and collect-only. Each carries its BRONZE-tier price.exampleRunInput.test/examples.test.ts — validates every example against ActorInputSchema,
recomputes its advertised price from pay_per_event.json and fails above 15%
drift, asserts each appears in the README, keeps the localized example under
$2.50, and rejects an example that lists the tracked brand as its own
competitor.publicConfig.publishedAt is set appears as an example. Creating the task is
API-writable; publishing it is Console-only (the API nulls publicConfig and
exposes no publish route). Four tasks were created from this file; publishing
them is a Console step. exampleRunInput is a separate, older field that
prefills the Input tab, and carries example 1.["Axonaut", "Sellsy"] — it listed
the tracked brand as its own competitor. Now ["Axonaut", "noCRM.io"], both
confirmed by a real French AI Overview that names "Axonaut, Sellsy et
noCRM.io". Prompts reduced from 5 to 4 to keep the run under $2.50, since
localized Google costs ~13x the default engine.it.each blocks expand at runtime, so a source-level count is always wrong. A
precise number that cannot be checked mechanically should not be published.Listing content only. No code, schema or pricing change.
"Use from an AI agent (MCP)" section near the top of the README: the
https://mcp.apify.com?tools=emoubarak/ai-brand-monitor connection URL, three
example prompts a user can say to their agent, and the agent-relevant facts
(pay-per-event, limited permissions, no Standby, collect-only) with the two
cost anchors taken from the existing table — $0.99 for 5 prompts x 2 samples
across four engines, $0.43 for a Google AI Overviews-only check.
The ?tools= query-parameter convention was checked against the current Apify
MCP documentation rather than assumed. One claim was corrected in the process:
the docs state the MCP server only accepts unauthenticated requests for
discovery tools, so running an Actor does require authorising Apify once in the
browser. The section says "no OpenRouter key" rather than "no API key".
Listing consistency fix. No behaviour change.
analysisMode entirely, and described analysisModel
as accepting "any OpenRouter model ID", which is only true under BYOK.schemaVersion: 1 and omitted the v2 fields, so it
contradicted the webhook section that tells consumers to branch on version 2.test/docs.test.ts — a drift guard that fails the suite when the README's
input table diverges from input_schema.json, when it names an event absent
from pay_per_event.json or omits a billable one, when the SUMMARY example
falls behind the schema version, or when the documented test count goes stale.Analysis key included by default, collect-only mode, per-engine cost breakdown.
ANALYSIS_OPENROUTER_KEY (secret Actor env var)
scores answers when the user supplies none, so the Actor now runs with no API
key required — the last onboarding step is gone and it is callable by an agent
with nothing to configure. openRouterApiKey becomes optional BYOK: the user
then pays OpenRouter directly, may use any model, and is billed the reduced
response-analyzed-byok event (~1/3 price). SUMMARY.analysisKeySource
reports which was used.openai/gpt-5.6-luna (default) and
deepseek/deepseek-v4-flash-0731, both validated with real calls against
AnalysisResultSchema at ~$0.0002/call. Anything else falls back to the default
with a warning, so one input field cannot point the owner's key at an expensive
model. Two candidates were rejected by that validation: openai/gpt-5-nano
returned an empty completion (reasoning tokens consumed its budget) and
openai/gpt-4.1-nano returned schema-valid but wrong extractions.analysisMode: "collect-only" — no LLM call, no analysis charge, raw
answers and citations only. Collection metrics and their deltas are still
computed; analysis-derived metrics are absent rather than zero.SUMMARY.costByEngine — samples, billable samples, estimated cost, cost
share and mention share per engine, for deciding which engines earn their place.SUMMARY.schemaVersion is now 2. SUMMARY is a webhook payload, so its
shape is a contract; consumers should branch on this field. Version 2 adds
analysisMode, analysisKeySource and costByEngine, and makes
analysis-derived metrics absent in collect-only mode.report-generated raised from $0.08 to $0.20 (FREE), with proportional
tiers ($0.125 BRONZE). The aggregation and delta layer is the differentiated
value; samples stay cheap. A default run moves +$0.12 at FREE, +$0.075 at
BRONZE — $2.64 to $2.72.analysis_failed when the run is
in collect-only mode; leaving it ok keeps the coverage report meaningful.Fourth engine, webhooks, and a listing rewritten around what buyers actually search for.
apify/gemini-search-scraper — the
official Apify Actor, same { queries } input and same sectioned-source output
shape as ChatGPT Search, so it reuses that parser. Measured unit cost $0.00505
(run gePTBPiX5pFk8wSo5), billed as prompt-sampled-gemini at $0.015 BRONZE.
engines now defaults to all four.webhookUrl and the finished summary — metrics,
coverage and deltas — is POSTed there as JSON at end of run: 10s timeout, two
retries, 4xx not retried. Failures are warned about and never fail the run.
Deliberately not billed: it is a retention feature, not a metered one.Production hardening. Billing model, per-engine pricing and real market targeting.
DOWNSTREAM_APIFY_TOKEN, a secret environment variable) instead of the token
injected into the user's run. An Actor started via the API runs under the
account of the token used, so the previous behaviour billed users at retail for
the engine scrapers on top of this Actor's pay-per-event charges. A run
without the token now fails at startup rather than silently double-charging.
See OPERATIONS.md for the cash-flow and concurrency exposure this creates.prompt-sampled is replaced by four per-engine events:
prompt-sampled-google-aio (primary), prompt-sampled-google-aio-localized,
prompt-sampled-perplexity and prompt-sampled-chatgpt. One Perplexity call
costs ~4x one Google AI Overview and a localized one ~13x; a single blended
price made cheap-engine users subsidize expensive ones. Every price is 3x the
measured downstream cost, floor $0.005.US is
served by johnvc/Google-AI-Overview-API, which accepts Google's own gl and
hl parameters. Verified: 10/10 French queries and 3/3 German queries returned
localized AI Overviews with local sources. The official Apify Actor exposes
only queries and cannot localize; Perplexity and ChatGPT Search expose no
country parameter at all.geoApplied on every sample row, plus sourceActor, so a user can tell which
answers were genuinely localized instead of inferring it. A run warns explicitly
about engines that could not honour the requested market.maxTotalChargeUsd on every downstream call, plus a per-run circuit breaker
(src/budget.ts) ceilinged at samples x worst-case unit cost x 1.5. On trip,
collection stops and the run reports partial coverage.OPERATIONS.md: billing exposure, measured costs with run IDs, monitoring to
configure in Console, and the deploy procedure.run.usageTotalUsd
is not settled when .call() returns — it holds only the $0.00005 actor-start
charge, with the per-result event landing moments later. The budget now charges
max(reported, worst-case unit cost).max_tokens: 800, which silently lost samples
whose answers named many brands: the JSON came back cut off mid-object and
failed validation twice. Raised to 2000, and a truncated completion now reports
itself as truncated instead of as malformed JSON.Initial release.
apify/perplexity-search-scraper, apify/google-ai-overviews-scraper and
apify/chatgpt-search-scraper. Every prompt is asked samplesPerPrompt
times per engine, with bounded concurrency (max 5), 3 retries with
exponential backoff and a per-call timeout.queries bypass generation entirely.openai/gpt-5.6-luna):
brand mention, position, sentiment with evidence, competitors named, and
which brand the answer recommends. Invalid JSON is retried once with the
validation error fed back into the prompt.ai-brand-monitor-state,
keyed by brand + market), including new and lost cited domains.prompt-sampled, response-analyzed and
report-generated. Failed engine calls are not charged. Collection stops
gracefully when the run's spending limit is reached.npm run local for a fully mocked end-to-end run at zero cost.prompt-sampled event across all engines (addressed in 0.2.0).