Exa Web Search

{
  "data": {
    "requestId": "d581de9ed6d77165",
    "resolvedSearchType": "neural",
    "results": [
      {
        "id": "https://github.com/example/x402-impl",
        "title": "x402 Payment Protocol — Reference Implementation",
        "url": "https://github.com/example/x402-impl",
        "publishedDate": "2026-03-15T00:00:00.000Z",
        "score": 0.94
      }
    ],
    "searchTime": 860,
    "costDollars": { "total": 0.007 }
  }
}

{
  "data": {
    "requestId": "601e412c9b1d0891",
    "answer": "x402 is an open payment standard built around the HTTP 402 status code...",
    "citations": [
      {
        "id": "https://x402.org",
        "title": "x402 - Payment Required | Internet-Native Payments Standard",
        "url": "https://www.x402.org"
      }
    ]
  }
}

{
  "data": {
    "results": [
      {
        "id": "https://x402.org",
        "url": "https://x402.org",
        "title": "x402 - Payment Required",
        "text": "x402 is an open, neutral standard for internet-native payments...",
        "author": null
      }
    ],
    "costDollars": { "total": 0.002 }
  }
}

// Step 1: Find relevant sources
const search = await client.exaSearch("x402 protocol adoption 2026", {
  numResults: 5,
  category: "news"
});

// Step 2: Read full content of top results
const urls = search.results.map(r => r.url);
const pages = await client.exaContents(urls);

// Step 3: Feed into LLM for analysis
const analysis = await client.chat("anthropic/claude-opus-4-6", [
  { role: "system", content: "Analyze based only on the provided sources." },
  { role: "user", content: `Sources:\n${pages.results.map(p => p.text).join("\n---\n")}\n\nQuestion: What is driving x402 adoption?` }
]);

const result = await client.exaAnswer(
  "How many x402 transactions happened in the last 30 days?"
);
// answer is grounded in real web sources with citations
console.log(result.answer);
console.log("Sources:", result.citations.map(c => c.url));

const similar = await client.exaFindSimilar("https://blockrun.ai", {
  numResults: 10,
  excludeSourceDomain: true
});
// Returns pages semantically similar to blockrun.ai — competitors, partners, alternatives

// Find GitHub repos implementing a specific pattern
const repos = await client.exaSearch(
  "x402 payment middleware implementation Next.js",
  { numResults: 5, category: "github" }
);

// Read the README of the most relevant repo
const readmes = await client.exaContents([repos.results[0].url]);
// Feed into coding agent context

const lastWeek = new Date();
lastWeek.setDate(lastWeek.getDate() - 7);

const news = await client.exaSearch("Coinbase x402 announcement", {
  category: "news",
  startPublishedDate: lastWeek.toISOString()
});

import { LLMClient } from '@blockrun/llm';

const client = new LLMClient({ privateKey: process.env.BASE_CHAIN_WALLET_KEY });

// Search
const results = await client.exaSearch("x402 payment protocol", { numResults: 5 });

// Get a cited answer
const answer = await client.exaAnswer("What is the x402 protocol?");

// Read page contents
const pages = await client.exaContents(["https://x402.org", "https://blockrun.ai"]);

// Find similar pages
const similar = await client.exaFindSimilar("https://blockrun.ai", { numResults: 10 });

from blockrun_llm import LLMClient

client = LLMClient()

# Search
results = client.exa_search("x402 payment protocol", num_results=5)

# Get a cited answer
answer = client.exa_answer("What is the x402 protocol?")
print(answer["answer"])

# Read page contents (batch URL fetching)
pages = client.exa_contents(["https://x402.org", "https://blockrun.ai"])

# Find similar pages
similar = client.exa_find_similar("https://blockrun.ai", num_results=10)

# Step 1: Request returns 402 with payment instructions
curl -X POST https://blockrun.ai/api/v1/exa/search \
  -H "Content-Type: application/json" \
  -d '{"query": "x402 protocol implementations", "numResults": 5}'

# Step 2: Pay and retry (SDK handles this automatically)
curl -X POST https://blockrun.ai/api/v1/exa/search \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <signed-payment-payload>" \
  -d '{"query": "x402 protocol implementations", "numResults": 5}'