REST API v1

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.

Base URL: https://visovra.com
Get API Key →

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.

Request header
Authorization: Bearer rs_live_xxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Keep your API key secret. Never expose it in client-side JavaScript or public repositories. Use environment variables to store it securely.

Rate Limits & Plan Limits

API access is gated by plan. Rate limits are enforced per API key per rolling 24-hour window.

PlanAPI Rate LimitPages per AuditAudit ReportsAPI Access
Free10 req/day153/mo—
Pro500 req/day50Unlimited✓
Agency2,000 req/day200Unlimited✓
EnterpriseUnlimited500Unlimited✓

Endpoints

All endpoints accept and return JSON. Errors are returned with HTTP status codes and a JSON body containing an error message.

POST/api/audit/start🔑 Auth required

Start 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

shell
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"}'
GET/api/audit/:id🔑 Auth required

Get 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

shell
curl https://visovra.com/api/audit/AUDIT_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/audit/list🔑 Auth required

List 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

shell
curl https://visovra.com/api/audit/list \
  -H "Authorization: Bearer YOUR_API_KEY"
DELETE/api/audit/:id🔑 Auth required

Delete an audit

Permanently deletes an audit and all associated findings. This action cannot be undone.

Response

{ "success": true }

Example cURL

shell
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.

StatusMeaningDescription
200OKRequest succeeded.
400Bad RequestInvalid parameters or missing required fields.
401UnauthorizedMissing or invalid API key.
403ForbiddenYour plan does not include API access.
404Not FoundThe requested resource does not exist.
429Too Many RequestsRate limit exceeded. Retry after the window resets.
500Server ErrorSomething 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.

Get Started Free →Talk to Sales