---
title: "Run an AI visibility audit"
method: POST
path: "/api/v1/ai-visibility-audit/run"
tags: ["AI Visibility Audit"]
---

# Run an AI visibility audit

`POST /api/v1/ai-visibility-audit/run`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/ai-visibility-audit/run`
- Auth: none declared

Runs a public, cached diagnostic for a work email, website, and hero prompt. This endpoint does not require an API key.

## Request body

- AIVisibilityAuditRequest
  - `work_email` string
  - `website` string
  - `hero_prompt` string

## Response `200`

AI visibility, homepage crawl, and Orbital Drift Stabilizer audit data.

- AIVisibilityAuditResponse
  - `website` string
  - `cached` boolean
  - `cacheVersion` string
  - `aiVisibility` AIVisibilityAuditVisibility
    - `provider` string
    - `coverage` string
    - `metricSource` string
    - `platform` string
    - `targetDomain` string
    - `mentionCount` integer
    - `aiSearchVolume` integer
    - `keywordSource` string
    - `sourceDomains` AIVisibilityAuditVisibilityDomainMetric[]
      - `domain` string
      - `mentions` integer
      - `aiSearchVolume` integer
    - `searchResultDomains` AIVisibilityAuditVisibilityDomainMetric[]
      - `domain` string
      - `mentions` integer
      - `aiSearchVolume` integer
    - `queries` AIVisibilityAuditVisibilityQuery[]
      - `query` string
      - `provider` string
      - `websiteMentioned` boolean
      - `citedUrls` string[]
      - `citedCompetitors` string[]
    - `citedCompetitors` string[]
    - `rawAggregatedMetrics` object
  - `crawl` AIVisibilityAuditCrawl
    - `requestedUrl` string
    - `finalUrl` string
    - `fetchMethod` string
    - `responseCode` integer
    - `contentType` string
    - `title` string
    - `metaDescription` string
    - `textLength` integer
  - `orbitalDriftStabilizer` AIVisibilityAuditDrift
    - `anchor` string
    - `averageDrift` number, double
    - `worstChunkDrift` number, double
    - `chunks` AIVisibilityAuditDriftChunk[]
      - `index` integer
      - `text` string
      - `similarity` number, double
      - `drift` number, double
    - `exampleCorrection` AIVisibilityAuditDriftCorrection
      - `chunkIndex` integer
      - `issue` string
      - `exampleRealignment` string
      - `speakRecommendation` string
      - `rewrite` string

## Other responses

- `400`: Missing or invalid website
- `422`: All homepage crawl and Zyte fallback paths returned too little content to run an audit.
- `500`: Diagnostic failed

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)