API reference

The gateway gives you access to data, LLMs, media, search, scraping, compute, and storage services through a single API. It holds the vendor accounts and settles with each provider for you. You pay per call, and only when the call succeeds. Start with the Quickstart.

Use a production API key for these examples. Keys in the OpenRecipe demo workspace are for preview only.

On this page 3 sections

One call shape
The services
Pricing model

One call shape

Every catalog action uses the same endpoint: POST /api/run/{service}/{action}. The request body contains the action’s inputs. Your API key goes in the Authorization header. Every response uses the same structure.

curl -X POST https://vaaya.ai/api/run/exa/search \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest developments in WebTransport", "numResults": 10}'

If you don’t know which service you need, POST /api/run/vaaya/consult (1¢) turns a plain-English request into exact calls. POST /api/run/vaaya/discover (free) searches the available endpoints.

The services

Each service page explains what the service does, what each action costs, and which vendor to pick.

Category	What it covers
Web search	Semantic, keyword, and cited-answer search across five vendors, from 1¢ per query.
OneSearch	Search multiple sources and compare the results in one fixed-price call.
OneFind	People as rows from a plain-English query. Find for 2¢, add contact data per filled field.
OneScrape	Read a list of URLs into structured rows. Standard retrieval costs 2¢ per URL; unblocking is billed per page read.
Web scraping	Content extraction, JS rendering, crawls, structured extraction, and anti-bot escalation.
Browser	Cloud browser sessions for clicking, typing, and form-filling.
LLMs	340+ models behind one OpenAI-compatible endpoint, metered per token.
Media	Image, video, audio, and speech generation. The model is a parameter.
Compute	Ephemeral sandboxes and GPU boxes for running code in isolation.
Files & storage	Durable file storage your agent can write and share.
Email	Inboxes your agent owns. Send, receive, and act on replies.
Commerce	Real-world actions: faxes, printed mail, purchases, hiring other agents.
GTM & leads	Find, enrich, and verify prospects. Research prospects and prepare outreach.
Research	Managed multi-step research runs that produce cited reports.
Public records	SEC filings, court dockets, nonprofit 990s, and H-1B salaries.
Real estate	US property records, valuations, listings, and owner data.
Social data	Profiles, posts, and comments across social platforms, including CN platforms.
On-chain & markets	Crypto, wallet forensics, and prediction-market data.
Compliance & KYB	Sanctions, PEP, adverse media, and company-registry checks.
Open data	Search the catalog for public datasets and specialist APIs.

Pricing model

Every action has a listed price in cents. It appears on the service page and in the machine-readable index.
You are only charged when a call succeeds. An upstream error charges you nothing.
Pass max_cost_cents to set a ceiling on any call. The response reports the actual charged_cents.
Personal accounts start with $2 welcome credit; Instinct accounts get $10, subject to signup checks. No card required. Every call is itemized at /balance.
Documented prices are defaults or ranges. Check GET /api/run/{service}/{action} before relying on a price in production.