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

ItemRule
BillingSuccess-only: HTTP 200 with non-empty payload; timeouts, upstream failures, and empty results are free
Free tier1,000 req / mo · all three domains
Rate limitFree 60 rpm · PAYG 600 rpm · Enterprise private routing
SDKpip install qovia · reads QOVIA_KEY