Documentation

API

OverviewAuthenticationMaking callsDiscoveryMCPErrors & billing

Core services

Web searchSuperSearchWeb scrapingBrowserLLMsMediaComputeFiles & storageMemoryEmail

Data & GTM

GTM & leadsResearchPublic recordsReal estateSocial dataOn-chain & marketsCompliance & KYBOpen data

vaaya / docs / reference

Discovery

Four ways to find the right call, from fully machine-readable to plain English. All discovery is free or 1¢ — never guess a service name.

The index and descriptors

EndpointWhat it returns
GET /api/runThe machine-readable index of every callable service and action.
GET /api/run/{service}/{action}One action’s descriptor: description, price, params schema.
/openapi.jsonThe canonical OpenAPI contract for the whole API.
/catalogThe human-browsable catalog.

The catalog’s long tail is thousands of endpoints (social data, compliance, on-chain, open data). vaaya/discover is a free keyword search over all of them, returning exactly what you need to make the call.

curl -X POST https://vaaya.ai/api/run/vaaya/discover \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "tiktok user followers"}'

# → [{ "service": "...", "action": "...", "endpoint": "...",
#      "price_cents": 1, "required_params": [...] }, ...]

vaaya/consult — plain English in, exact calls out

vaaya/consult (1¢) is a conversational routing engine: describe what you want and it hands back the exact call(s) — service, action, params, and a sensible max_cost_cents — asking one short question if a load-bearing detail is missing. It remembers the conversation, so multi-step work can be planned across turns.

curl -X POST https://vaaya.ai/api/run/vaaya/consult \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intent": "find the verified email of the CEO of stripe"}'