Read an AuditAE audit's stored results, per prompt and engine: brand URL cited or brand named, competitors cited or named, the cited URLs; plus summary rates, the audit's playbook and a shareable report_url. Asks no engine.
Billing: free; works at a zero balance.
When to call: before paying for new checks, to see where competitors are cited instead of the brand (list_sites' latest_audit.audit_id or another tool's audit_id); then get_fix_plan.
Inputs:
audit_id — required.
only_lost — true: only answered cells without the brand's URL.
prompt — only prompts containing this text (any case).
max_urls — cited URLs per cell, default 5 (0–50); brand and competitor URLs always listed.
include_answers — true adds answer_excerpt (~320 chars around the brand mention).
Returns { audit_id, brand, domain, status, created_at, engines, prompt_count, competitor_domains, visibility_score, failure_reason, report_url, charged_cents, charged_breakdown_cents: {checks, playbook}, summary: {answered, total, cited, mentioned, citation_rate, mention_rate, prompts_lost, by_engine: [{engine, answered, cited, mentioned}], competitors: [{domain, cited_cells, cited_where_brand_not}], top_cited_domains: [{domain, cells}], top_competitors_mentioned: [{name, cells}], suggested_competitor_domains: [{domain, cells}]}, do_this_first?: [{priority, title, description, closes_lost_cells, target_hosts}], results: [{prompt, engines: [{engine, status, cited, mentioned, competitors_cited, competitors_mentioned, urls, more_urls?, answer_excerpt?}]}], suggested_next?, next_step? }. An unanswered cell is {engine, status, error}. summary covers every cell; filters narrow only results. While "running", results and charged_cents cover cells answered so far; report_url is null. do_this_first: the top 3 actions of the audit's playbook (already billed; absent until written). suggested_competitor_domains: untracked non-platform hosts cited where the brand wasn't; confirm with the user before add_site.
Example: { audit_id: "…", only_lost: true }