Home/Docs & API
v2026.06 API reference

Build on the same agent loop.

REST API, webhook events, and the full skill catalog the agents are wired with. Free tier includes 1,000 calls/month. CMS connector SDK and prompt probe endpoints are part of v1 — see endpoint reference below.

Quickstart

Audit a URL, get a JSON report, ship a fix to your CMS — all in one request.

$ curl https://api.visibilitypro.ai/v1/audits \
  -H "Authorization: Bearer $VP_KEY" \
  -d '{"url": "https://your-site.com/page", "depth": "full"}'

Response (truncated):

{
  "id": "aud_8f3a21c",
  "url": "https://your-site.com/page",
  "score": 64,
  "findings": [
    {
      "agent": "content-agent",
      "severity": "high",
      "issue": "answer-first intro missing",
      "passage": "...",
      "suggested_fix": "...",
      "fix_id": "fix_9c2"
    }
  ],
  "next_actions": ["export_task"]
}

Authentication

All requests authenticate via bearer token. API key issuance is currently in development — sign up for early access. Scoped keys (read-only, prompt-only, full) planned on Agency+.

Rate limits

API keys are currently in development. Rate limits below reflect the planned values — sign up to be notified at launch.

  • Free: 1,000 calls/month, 10 req/min
  • Pro: 10,000 calls/month, 60 req/min
  • Agency: 100,000 calls/month, 600 req/min
  • Enterprise: negotiated, region-pinned

Limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) on every response.

Webhooks

Subscribe to events at the workspace level:

  • audit.completed — agent finished, findings available
  • finding.created — new high-severity issue
  • fix.drafted — CMS draft created, awaiting approval
  • fix.shipped — change published to live site
  • citation.gained — new citation detected on a tracked engine
  • citation.lost — previously-cited brand fell out of an answer
  • hallucination.detected — engine asserting a falsifiable claim about your brand
  • crawler.anomaly — >25% w-o-w fetch drop on a tracked bot

Every payload is signed with HMAC-SHA256 over the request body. Verify the X-VP-Signature header before trusting the event.

CMS connector SDK

The CMS connector SDK lets you implement custom discover(), draft(), preview(), and publish() methods for any CMS. Built-in connectors: WordPress, Shopify, Webflow, Drupal, Magento, Joomla, Squarespace + Wix (assist mode), GitHub + GitLab PR mode (Next.js / Nuxt / Astro / Hugo / Gatsby). Sign up to obtain SDK keys.