Visovra API
Documentation
Programmatically trigger GEO analyses, retrieve live GEO Scores, and integrate Visovra's AI Engineering Intelligence into your own tools, dashboards, CI pipelines, and agency workflows.
Authentication
All API requests must include your API key in the Authorization header using Bearer token format. You can find your API key in Account Settings.
Authorization: Bearer rs_live_xxxxxxxxxxxxxxxxxxxxxxxx
Rate Limits & Plan Limits
API access is gated by plan. Rate limits are enforced per API key per rolling 24-hour window.
| Plan | API Rate Limit | Pages per Audit | Audit Reports | API Access |
|---|---|---|---|---|
| Free | 10 req/day | 15 | 3/mo | — |
| Pro | 500 req/day | 50 | Unlimited | ✓ |
| Agency | 2,000 req/day | 200 | Unlimited | ✓ |
| Enterprise | Unlimited | 500 | Unlimited | ✓ |
Endpoints
All endpoints accept and return JSON. Errors are returned with HTTP status codes and a JSON body containing an error message.
/api/audit/startStart a new GEO analysis
Enqueues a GEO analysis for the given URL — live citation checks across ChatGPT, Gemini, Perplexity, Claude, and Copilot, plus technical checks and GPT-4o fix plan generation. Returns the analysis ID to poll for results.
Request Body
{ "url": "https://example.com" }Response
{ "auditId": "cuid", "status": "pending" }Example cURL
curl -X POST https://visovra.com/api/audit/start \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'/api/audit/:idGet GEO analysis result
Returns the full GEO analysis result including GEO Score (0–100), per-platform citation data, competitor comparison, and GPT-4o GEO recommendations. If the analysis is still running, status will be "running".
Response
{ "id": "...", "status": "completed", "overallScore": 78, "geoScore": 64, "findings": [...] }Example cURL
curl https://visovra.com/api/audit/AUDIT_ID \ -H "Authorization: Bearer YOUR_API_KEY"
/api/audit/listList all GEO analyses
Returns all GEO analyses for your account, ordered newest first. Includes pagination via ?page=1&limit=20 query params.
Response
{ "audits": [{ "id": "...", "url": "...", "status": "completed", "overallScore": 78, "geoScore": 64 }] }Example cURL
curl https://visovra.com/api/audit/list \ -H "Authorization: Bearer YOUR_API_KEY"
/api/audit/:idDelete an audit
Permanently deletes an audit and all associated findings. This action cannot be undone.
Response
{ "success": true }Example cURL
curl -X DELETE https://visovra.com/api/audit/AUDIT_ID \ -H "Authorization: Bearer YOUR_API_KEY"
Error Codes
Visovra uses standard HTTP status codes. All errors include a JSON body with an error key.
| Status | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid parameters or missing required fields. |
| 401 | Unauthorized | Missing or invalid API key. |
| 403 | Forbidden | Your plan does not include API access. |
| 404 | Not Found | The requested resource does not exist. |
| 429 | Too Many Requests | Rate limit exceeded. Retry after the window resets. |
| 500 | Server Error | Something went wrong on our end. Contact support if this persists. |
Ready to integrate?
Get your API key from the settings page. Pro, Agency, and Enterprise plans include full REST API access to GEO analyses, scores, webhooks, and AI Engineering Intelligence data.