Quickstart

Get an API key

Sign in at helve.dev with Google, GitHub, or email. Every new account starts with $2 of credits, no card required. On the API keys tab, name a key and create it. The full key is shown once; copy it somewhere safe.

Make a search

Send the key as a bearer token. Everything under /v1 uses the same header.

curl -s https://helve.dev/v1/search \
  -H "Authorization: Bearer $HELVE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query": "latest research on speculative decoding", "max_results": 5}'

import { Helve } from "helve-sdk"; // npm install helve-sdk

const helve = new Helve({ apiKey: process.env.HELVE_API_KEY });
const { results, provider, usage } = await helve.search({
  query: "latest research on speculative decoding",
  max_results: 5,
});

from helve import Helve  # pip install helve

helve = Helve()  # reads HELVE_API_KEY
data = helve.search("latest research on speculative decoding", max_results=5)
print(data["provider"], data["usage"]["cost_usd"])

Read the response

Every response has the same envelope: which provider served it, the results, how the request was adjusted, and what it cost.

{
  "id": "srch_01j…",
  "provider": "exa",
  "results": [
    {
      "id": "res_…",
      "url": "https://arxiv.org/abs/2211.17192",
      "title": "Fast Inference from Transformers via Speculative Decoding",
      "snippets": ["We introduce speculative decoding, an algorithm to sample from …"],
      "score": 0.91,
      "score_synthesized": false,
      "published_date": "2022-11-30",
      "raw": { "…": "the engine's original result" }
    }
  ],
  "warnings": [],
  "usage": { "cost_usd": 0.005, "credits": 0 },
  "latency_ms": 812
}

Pick a provider, or a panel

Add "provider": "tavily" to route to a specific engine, or "provider": "fusion" to merge several engines’ top picks. Nothing else in the request or response changes. See Providers and Fusion.

What next

Extract pages

Turn the URLs you found into clean markdown.

Transcribe audio

Submit a recording, poll a job, read the transcript.

Connect your agent

Helve is an MCP server. One command adds every tool to Claude Code or Cursor.

Use an SDK

TypeScript and Python clients typed from the same spec.

Get started

Tools

Concepts

Integrations

What next

Extract pages

Transcribe audio

Connect your agent

Use an SDK

​What next

Extract pages

Transcribe audio

Connect your agent

Use an SDK

What next