# TOP GUN GEO-Lens Brand Visibility Quick Check

> TOP GUN GEO-Lens Brand Visibility Quick Check is a paid API for AI agents from top-gun-mcp-server.vercel.app, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Audits how a brand appears in LLM and AI search responses for a given query, returning a visibility score, label, and citation sources

## Facts

- Endpoint: POST https://top-gun-mcp-server.vercel.app/api/v1/quick-check
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/top-gun-geo-lens-brand-visibility-quick-check-eeb94dea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aLGQ8Bbev3hi_rY-xs_Bk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability top-gun-geo-lens-brand-visibility-quick-check-eeb94dea -d '<json body>'
```

Example prompt: Can you run a GEO-Lens quick check on 'Acme Corp' for the query 'best project management software for small teams' and compare it against competitors Asana and Monday.com?

## When to prefer this

Use this endpoint when you need a fast, single-call snapshot of how a specific brand performs in LLM and AI answer engine responses for a defined query — especially when you want a normalized 0–100 score, citation evidence, and actionable tips in one response. Prefer this over full audit endpoints when speed and simplicity matter more than exhaustive crawl depth.

## Known failure modes

- Missing required 'brand' field returns 400 validation error
- Missing required 'query' field returns 400 validation error
- Payment not provided or insufficient USDC returns 402 payment required
- Brand not found in any AI search source returns label 'Not Found' with score 0
- Upstream Brave or Exa search unavailable returns 503 or degraded results
- Invalid competitor array format may cause partial results

## How this service works

TOP GUN GEO-Lens audits how brands appear across LLMs, AI search, answer engines, and recommendation systems.

## Output

Returns a visibility score from 0–100, a categorical label (Strong, Moderate, Weak, or Not Found), an array of top citations with URL, title, snippet, and source (brave or exa), actionable quick tips to improve LLM visibility, and the timestamp of the audit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "brand",
  "query"
 ],
 "properties": {
  "brand": {
   "type": "string",
   "description": "The company or brand name"
  },
  "query": {
   "type": "string",
   "description": "The search prompt to test visibility against"
  },
  "competitors": {
   "type": "array",
   "description": "Optional competing brands to compare against"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "score",
  "label",
  "topCitations",
  "quickTips",
  "checkedAt"
 ],
 "properties": {
  "label": {
   "enum": [
    "Strong",
    "Moderate",
    "Weak",
    "Not Found"
   ],
   "type": "string"
  },
  "score": {
   "type": "number",
   "maximum": 100,
   "minimum": 0,
   "description": "Visibility score (0–100)."
  },
  "checkedAt": {
   "type": "string",
   "format": "date-time"
  },
  "quickTips": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "topCitations": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "url",
     "title",
     "snippet"
    ],
    "properties": {
     "url": {
      "type": "string",
      "format": "uri"
     },
     "title": {
      "type": "string"
     },
     "source": {
      "enum": [
       "brave",
       "exa"
      ],
      "type": "string"
     },
     "snippet": {
      "type": "string"
     },
     "position": {
      "type": "integer",
      "minimum": 1
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/top-gun-geo-lens-brand-visibility-quick-check-eeb94dea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from top-gun-mcp-server.vercel.app](https://www.zero.xyz/host/top-gun-mcp-server.vercel.app/llms.txt)
