Ask one question of AI answer engines now; per engine: brand URL cited?, brand named and where, competitors named, cited sources, sentiment. Saved as a citation audit.
Billing: 5–12¢ per engine check — Perplexity 5¢, ChatGPT 7¢, AI Overviews 9¢, Gemini 12¢ (33¢ a prompt on the four defaults), AI Mode 10¢ if asked; only answered checks bill (a repeat within an hour is cached but billed). Then the fix-it playbook get_fix_plan plans from (playbook: false skips it): at most 12¢ per answered check that didn't cite the brand, plus about 45¢ for a rollup when 2+ questions were lost. Default engines: 33¢ + at most 48¢ playbook. dry_run: true quotes it free.
When to call: ask the engines now about one question, or re-check one after a fix. An audit that already ran: get_audit (free); many questions: get_share_of_voice.
Returns { audit_id, report_url (public; give it to the user), results: [{engine, status, brand_mentioned, brand_url_cited, position, competitors, sources, sentiment, was_cache_hit, error_message, answer_excerpt}], citation_rate, completed, total, partial, out_of_credits, charged_cents, charged_breakdown_cents }. Past ~45 s: { audit_id, status: "running", next_step }; it finishes in the background (read with get_audit).