## panorama/ai-visibility

`GET /v1/panorama/ai-visibility`

How often each answer engine names the brand and its competitors across repeated runs of the prompts, per engine, with the domains the engines cited ranked. Costs are the engines' metered model prices.

*AI visibility*

| Parameter | Required | Description |
| --- | --- | --- |
| `brand` | yes | Literal brand name, 1–200 characters. — e.g. `My Brand` |
| `prompts` | no | JSON array of strings or \|-separated prompts, each at most 2,000 characters. Required unless topic is supplied. — e.g. `["Which project tools are useful?"]` |
| `topic` | no | Build one default prompt if prompts is absent. — e.g. `project collaboration` |
| `competitors` | no | Up to five distinct comma-separated names, each at most 200 characters. — e.g. `Other Brand` |
| `engines` | no | Explicit engine subset; default both. Availability depends on configured eligible supply. — e.g. `perplexity,grok` |
| `preset` | no | quick: 2 runs/3 prompts; standard: 4/8; deep: 8/20. Default quick. Preset still caps prompts when runs is explicit. — e.g. `quick` |
| `runs` | no | Integer 1–20. Explicit value overrides preset repetitions. Total planned probes must fit the deployment cap (default 40). — e.g. `1` |
| `brand_domains` | no | Comma-separated domains to label yours in cited_domains. — e.g. `example.com` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 30 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/panorama/ai-visibility?brand=My%20Brand" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "brand": "My Brand",
  "competitors": [],
  "engines": [
    "perplexity"
  ],
  "prompts": [
    "Which project tools are useful?"
  ],
  "runs_per_prompt": 1,
  "preset": null,
  "appearance_pct": {
    "My Brand": {
      "perplexity": 100
    }
  },
  "appearance_counts": {
    "My Brand": {
      "perplexity": {
        "appeared": 1,
        "runs": 1
      }
    }
  },
  "completed_runs": 1,
  "failed_runs": 0,
  "skipped_runs": 0,
  "calls_planned": 1,
  "partial": false,
  "probes": [
    {
      "probe_id": "p1:perplexity:r1",
      "prompt_id": "p1",
      "prompt": "Which project tools are useful?",
      "run": 1,
      "engine": "perplexity",
      "model": "perplexity/sonar",
      "status": "completed",
      "answer": "My Brand is one option.",
      "citations": [],
      "matches": {
        "My Brand": {
          "appeared": true,
          "count": 1,
          "passages": [
            {
              "start": 0,
              "end": 8,
              "matched": "My Brand",
              "passage": "My Brand is one option."
            }
          ],
          "truncated": false
        }
      }
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/panorama/ai-visibility#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/panorama/ai-visibility.json)