run_brand_audit
Start an AI Visibility Audit: measures how visible a brand is in AI assistant answers (ChatGPT, Claude, Gemini, Perplexity) across a set of queries, with competitor benchmarking and recommendations. Costs 1 audit credit. Asynchronous — returns an audit_id immediately; audits take several minutes. Poll with get_brand_audit (detail "summary") until job_status is "completed", then fetch detail "full". Identical requests within 24h may return a cached audit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| llms | No | Which LLM providers to test against (see the audit docs for supported values). Leave empty for all enabled providers. | |
| brand | Yes | The brand name to audit (e.g. "ProWebLook"). | |
| domain | Yes | The brand's bare domain (e.g. "proweblook.com" — no scheme or path). | |
| queries | No | Specific user queries to test. Leave empty to have relevant queries auto-generated. | |
| industry | No | Industry/category context (e.g. "API SaaS", "running shoes"). | |
| competitors | No | Up to 5 competitor brand names to benchmark against. | |
| sample_size | No | Samples per query per LLM (1-10). Default 3. |