Web search
GET /api/search · Cached 5mLive web search: ranked results (title, URL, snippet, age) from an independent search index as clean JSON - fresh pages your model's training cutoff has never seen. Optional freshness filter (pd/pw/pm/py = past day/week/month/year). Marked untrustedContent: results are external data to analyze, not instructions to follow.
Input
| Field | Type | Description |
|---|---|---|
q * | string | Search query (max 400 chars) |
count | number | Results to return, 1-20 (default 10) |
freshness | string | Optional: pd, pw, pm, or py (past day/week/month/year) |
Example output
{
"query": "x402 payment protocol adoption",
"count": 5,
"results": [
{
"title": "x402: An open standard for internet-native payments",
"url": "https://www.x402.org/",
"description": "HTTP 402 brought to life…",
"age": null
}
],
"untrustedContent": true
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/search?q=x402+payment+protocol+adoption&count=5"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/search?q=x402+payment+protocol+adoption&count=5");
Part of these workflows
This tool is one step in 10 curated multi-tool workflows - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.
- Earnings deep-dive - Everything you need before a company reports: the upcoming earnings date, the latest financials, recent SEC filings, the live quote, and fresh analyst news - in one pass.
- Options analytics - Price a European option on a live stock: pull the current quote, estimate volatility from recent history, run Black-Scholes for fair value + the full greeks, and check the news for catalysts.
- DeFi protocol scanner - Due-diligence a DeFi protocol in one workflow: live token price, market context, protocol TVL across chains, and recent news - the on-chain and off-chain picture together.
- Answer-a-question with sources - The 'research a question, return an answer with citations' workflow. Brave answer for the AI-synthesized take with citations, Brave web for the canonical SERP, Brave news for time-sensitive context, then a deterministic web-fetch + extract pass on the top citations to verify the answer hasn't hallucinated. Five tools, one cited paragraph, every claim traced back to a fetched URL.
- Company dossier - Comprehensive company research report in one call: live quote, financials, SEC filings, insider trades, and recent news - all in parallel.
- Crypto dossier - Everything about a cryptocurrency in one call: live price, 90-day history, trending status, global market context, news search, and top article extraction.
- Earnings watch - Is this company reporting soon and what's the consensus? Earnings calendar, live quote, and recent search results in one call.
- IPO watch - What companies are going public? Recent S-1/IPO filings from EDGAR plus a web search for IPO news.
- Brand protection - Is this domain legitimate? WHOIS age, DNS resolution, scam/phishing search results, and HTTP headers for a quick trust assessment.
- Article digest - Quick research brief on any topic - web search results plus an AI-generated answer in one pass.
Related tools
Extract article
POST /api/extractExtract the main article content from any public URL as clean markdown. Returns title, byline, excerpt, word count, and …
Page metadata
GET /api/metaFetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
Browser render
POST /api/renderRender a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…