API Overview
The Surva.ai API provides programmatic access to your AI visibility data. Use it to integrate Surva.ai insights into your own dashboards, reports, or workflows.
Authentication
All API requests require authentication using an API key. Generate your API key from the account settings page. Include the key in the request header:
Authorization: Bearer YOUR_API_KEYBase URL
https://www.surva.ai/api/Available Endpoints
- GET /api/visibility - retrieve AI visibility scores and platform breakdown
- GET /api/mentions - list brand mentions across AI platforms
- GET /api/citations - retrieve citation data
- GET /api/competitors - list tracked competitors and their visibility
- GET /api/prompts - list tracked prompts and their status
Rate Limits
API rate limits depend on your subscription plan. All responses include rate limit headers indicating your remaining requests.
Response Format
All API responses return JSON. Successful responses use HTTP 200. Errors return appropriate HTTP status codes with a JSON error message.