Tool Reference

Look up a brand in the Optimly Brand Trust Registry by name or slug. Returns its public registry identity, BAI tier, archetype, category, and profile URL.

All authenticated brand accounts

Return the current AI-perception narrative for a brand, including positioning, sentiment, accuracy gaps, competitive associations, claims, and sources when available.

All authenticated brand accounts

Compare a primary brand with up to five competitors on AI representation, archetype, BAI tier, sentiment, positioning, and key discrepancies.

All authenticated brand accounts

Generate prioritized recommendations for improving how AI represents a brand, grounded in its registry profile and source-graph findings.

All authenticated brand accounts

Return Business Profile baseline version, last-edit timestamps, and section summaries for the authorized brand.

Partner Program or approved access with read_brand permission

Read all 15 verified ground-truth sections for the authorized brand.

Partner Program or approved access with read_brand permission

Return the latest or a selected Brand Authority Index audit summary, including run metadata and component scores.

Partner Program or approved access with read_brand permission

Return per-question, per-model answers from a completed audit, including answer text, expected ground truth, accuracy, and owned versus third-party citations.

Partner Program or approved access with read_brand permission

List completed audit runs newest-first with component scores and run-over-run deltas.

Partner Program or approved access with read_brand permission

Return the authorized brand's latest private competitive analysis across AI models.

Partner Program or approved access with read_brand permission

Report score changes, narrative drift, competitor movement, and alerts since a selected date.

Partner Program or approved access with read_brand permission

Audit key website pages from an AI crawler's perspective: rendering, AI-bot robots rules, structured data, metadata, llms.txt, status, and visible content.

Partner Program or approved access with read_brand permission

Aggregate citations from an audit and classify sources as owned or third-party, with grounded-answer rates and accuracy comparisons.

Partner Program or approved access with read_brand permission

Return ranked information gaps for the selected brand, with observed demand, supply weakness, corroboration, score, status, and raw supporting evidence.

Partner Program or approved access with read_brand permission

Pin, target, hold, dismiss, or reopen a whitespace candidate. Targeted candidates require a durable action reference for attribution.

Partner Program or approved access with read_brand permission

Rank third-party publications and the category angles they own in the brand's citation graph, including authority, model breadth, accuracy, and pitch signals.

Partner Program or approved access with read_brand permission

Find lookalike publications the brand does not yet win, labeling candidates by discovery source and verification level.

Partner Program or approved access with read_brand permission

Execute one exactly approved Business Profile mutation. The call atomically starts the action and consumes its approval.

Approved access with manage_brand_vault permission and a valid approval