Documentation
Getting Started
Three lines to your first result. Base URL: https://api.qovia.ai; auth via Bearer API key (free tier 1k/mo on sign-up).
Authentication
HTTP Headerrequired
Authorization: Bearer sk-qovia-…First call
# One query, three domains curl https://api.qovia.ai/v1/search \ -H "Authorization: Bearer $QOVIA_KEY" \ -d '{ "query": "consumer sentiment on new EV launches", "domains": ["social", "ecommerce", "web"], "freshness": "24h", "format": "vectors+provenance" }'
from qovia import Client qv = Client() # reads QOVIA_KEY results = qv.search( query="consumer sentiment on new EV launches", domains=["social", "ecommerce", "web"], freshness="24h", ) for r in results: print(r.text, r.provenance.hash)
// Drop into any MCP-compatible agent { "mcpServers": { "qovia": { "url": "https://mcp.qovia.ai/sse", "env": { "QOVIA_KEY": "sk-..." } } } }
Billing & rate limits
| Item | Rule |
|---|---|
| Billing | Success-only: HTTP 200 with non-empty payload; timeouts, upstream failures, and empty results are free |
| Free tier | 1,000 req / mo · all three domains |
| Rate limit | Free 60 rpm · PAYG 600 rpm · Enterprise private routing |
| SDK | pip install qovia · reads QOVIA_KEY |