documentation

api reference

Send search queries to Vexa and get structured results back. Authenticate with your API key via the x-api-key header.

authentication

API Key

All API requests require an API key. Pass it in the x-api-key header.

curl -H "x-api-key: sx_..." https://api.vexa/search

Get your API key by signing in with GitHub or Google.

endpoints

POST/api/search

Raw SearXNG results. No AI processing.

curl -X POST https://api.vexa/api/search \
  -H "x-api-key: sx_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "rust vs go performance"}'

POST/api/search/analyze

Raw results + Groq AI summary with key insights and relevance scoring.

curl -X POST https://api.vexa/api/search/analyze \
  -H "x-api-key: sx_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "rust vs go performance"}'

POST/api/search/deep

SSE stream with 3 refinement rounds. Synthesized report with sources.

curl -X POST https://api.vexa/api/search/deep \
  -H "x-api-key: sx_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "rust vs go performance"}'

request body

field	type	required	description
query	string	yes	The search query
limit	number	no	Max results to return (default: all)