Documentation

Start

OverviewQuickstartAuthenticationMaking callsDiscoveryMCPErrors & billing

Guides

Web searchOneSearchOneFindOneScrapeResearchWeb scrapingGTM & leads

Data APIs

Public recordsReal estateSocial dataOn-chain & marketsCompliance & KYBOpen data

Execution APIs

BrowserLLMsMediaComputeFiles & storageEmailCommerce

vaaya / docs / reference

Discovery

There are four ways to find the right call, from fully machine-readable to plain English. Discovery is free or 1¢.

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, and params schema.
/openapi.jsonThe canonical OpenAPI contract for the whole API.
/catalogThe human-browsable catalog.

The catalog has a long tail of thousands of endpoints for social data, compliance, on-chain, and open data. vaaya/discover is a free keyword search over all of them. It returns everything 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¢) turns a plain-English request into exact calls. Describe what you want and it returns the service, action, params, and a suggested max_cost_cents. It asks one short question if a load-bearing detail is missing, and it remembers the conversation 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"}'