add_brand
ChatGPTStart measuring a brand: does ChatGPT, Perplexity, Claude or Google AI mention it, and who does AI recommend instead? Give the brand's website (or its app store, Google Maps, YouTube or Instagram link). It reads the site, picks the buyer questions, and starts the first scan across the AI engines. Reading the site takes 1-2 minutes; if it is still running, call again with the same link and it picks up the same run, never a second one. Returns the brand_id; then use get_scan_status.
create_prompt
ChatGPTAdds a buyer question to a topic so it is asked on every engine in the plan from the next run. Counts toward the plan's question limit. Calling again with the same text returns the existing question, never a duplicate.
get_changes
ChatGPTWhat moved over the window: the daily mention-rate trend, how much the engines' answers changed, notable changes on competitors' websites, and new pages about the category.
get_citations
ChatGPTThe websites AI answers cite for the brand's buyer questions, ranked by share of citations and by how many answers cite them, and where the brand's own site ranks.
get_competitors
ChatGPTThe competitors AI answers name for the brand's buyer questions, per engine, with each one's share of voice against the brand and how it changed over the window.
get_fix_verification
ChatGPTEach fix marked shipped for the brand with its mention rate before and after and a verdict: moved (beyond normal answer churn), within_noise, or awaiting_samples. Fixes marked "Not a fix" are left out; auto-detected page changes carry source auto_detected.
get_loop
ChatGPTThe brand's loop, oldest first: each buyer question tracked, gap found, content draft created, fix published to the brand's site, fix shipped, change seen on the brand's own pages, and fix checked after it ships: early reads on days 7 and 14, the verdict on day 28 and a final check on day 45 (whether it is still live and how citations, mentions and AI-referral traffic moved, each with its sample size; a horizon appears only once it has been measured). The first page also lists before_window: each question's newest draft, publish and shipped fix from before since, its current state. At most 90 days per call (the last N days is since = today minus N-1, today counted); page with next_cursor.
get_report_link
ChatGPTA link to the brand's AI visibility report to share with a team or client: how often AI answers mention the brand, which competitors they name instead, and which sources they cite. Returns the newest finished report's own unlisted link. Reports are built automatically after a brand's first scan.
get_scan_status
ChatGPTProgress of a brand's first scan after add_brand: the stage, how many AI answers are in out of how many expected, per engine, and when it should finish. Once complete, use get_visibility for the results.
get_visibility
ChatGPTHow often ChatGPT, Perplexity, Claude and Google AI mention the brand when buyers ask about its category. by=engine (default): mention rate, share of voice, average position, citation share and sentiment per engine, with the change from the previous period. by=question: each buyer question's mention rate and rank.
list_brands
ChatGPTThe brands this workspace tracks in AI answers, with ids and websites. Call first; every other tool takes a brand_id.
list_fix_opportunities
ChatGPTThe gaps that keep AI engines from citing or recommending the brand, each with its evidence and the suggested fix. Gives the gap_id mark_fix_shipped needs.
list_topics
ChatGPTThe topics and buyer questions this workspace asks ChatGPT, Perplexity, Claude and Google AI for a brand. Gives the topic_id create_prompt needs.
mark_fix_shipped
ChatGPTRecords that a fix shipped, against a gap_id from list_fix_opportunities or a published content_draft_id, so get_fix_verification can measure whether it moved the brand's mention rate. Calling again with the same fix and description returns the existing record.
open_proofsource
ChatGPTOpens the AI visibility card for one of your brands: how often AI answers mention it, per engine, the competitors they name instead, and sample answers.
search_brand_mentions
ChatGPTTypeahead search over the brands this workspace tracks, for @-mentions in the composer.