search402

Try it

# 1. Call the endpoint
curl https://search402.dev/v1/search?q=bitcoin

# Response: 402 Payment Required
# Headers include x402 payment instructions

# 2. With an x402 client, payment is automatic:
import { x402Client, x402HTTPClient } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";

const client = new x402Client();
registerExactEvmScheme(client, { signer: account });
const http = new x402HTTPClient(client);

const res = await http.get("https://search402.dev/v1/search?q=bitcoin");
// Payment handled automatically, results returned

Endpoints

GET /v1/search

Search the web. Returns structured results with titles, URLs, and snippets.

{
  "query": "bitcoin",
  "results": [
    { "title": "Bitcoin Price", "url": "https://...", "snippet": "...", "position": 1 }
  ],
  "related_searches": ["bitcoin news"],
  "knowledge_panel": null,
  "timestamp": "2026-03-04T16:00:00Z"
}

GET /v1/fetch

Fetch any URL and get clean markdown content.

{
  "url": "https://example.com",
  "title": "Example Domain",
  "content": "# Example Domain\n\nThis domain is for use in illustrative examples.",
  "word_count": 10,
  "timestamp": "2026-03-04T16:00:05Z"
}

Pricing

$0.005 USDC per call on both endpoints. Pay per request — no subscription, no API key, no account.

How it works

search402 uses the x402 protocol — an open standard for HTTP-native micropayments.

1. Agent calls an endpoint (e.g. /v1/search?q=bitcoin)
2. Server responds 402 Payment Required with payment details in headers
3. Agent's x402 client signs a USDC authorization on Base
4. Agent retries the request with payment proof in headers
5. Server verifies payment via CDP facilitator, returns results

Links

• API manifest — machine-readable endpoint specs
• llms.txt — LLM-friendly service description
• GitHub
• x402.org — the payment protocol