Search and Read

Search and read in one call: runs a web search (or news search) and returns the top 1 to 5 result pages as clean Markdown together with title, URL and snippet, so the agent gets content instead of links. Pages that cannot be read are reported per result. Charged only if at least one page was read. Params: query (required), source ('web' default or 'news'), count (1 to 5, default 3), max_chars per page (500 to 20000, default 4000).

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/search-read", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"query":"x402 payment protocol","count":2,"max_chars":3000}),
});
const { data, payment } = await res.json();  // payment.transaction = on-chain receipt

Input

Output

Example response (data)

{
  "query": "x402 payment protocol",
  "source": "web",
  "summary": {
    "heading": "The Graph",
    "abstract": "The Graph is an open-source, decentralized protocol that powers the indexing and querying of blockchain data. It enables developers to build scalable web3 de…",
    "answer": null
  },
  "ok_count": 1,
  "results": [
    {
      "rank": 1,
      "title": "The Graph - Wikipedia",
      "url": "https://en.wikipedia.org/wiki/The_Graph",
      "snippet": " a platform designed to manage payments and policies for autonomous AI agents. It's built on Coinbase’s x402 protocol and Google’s agent-to-agent (A2A)",
      "ok": true,
      "markdown": "[Jump to content](#bodyContent)\n\nFrom Wikipedia, the free encyclopedia\n\n![](//thumb.wikimedia.org/wikipedia/en/thumb/b/b4/Ambox_important.svg/40px-Ambox_impo…",
      "word_count": 38
    }
  ],
  "fetched_at": "2026-10-06T14:29:39.582Z"
}