News search
GET /api/search-newsLive news search: ranked recent articles (title, URL, snippet, age, source, breaking flag) from an independent search index as clean JSON. Same freshness filter as web search (pd/pw/pm/py). Optimized for current-events queries where the web index lags.
Input
| Field | Type | Description |
|---|---|---|
q * | string | Search query (max 400 chars) |
count | number | Results to return, 1-50 (default 10) |
freshness | string | Optional: pd, pw, pm, or py (past day/week/month/year) |
country | string | Optional 2-letter country code (default US) |
Example output
{
"query": "Federal Reserve interest rate decision",
"count": 3,
"results": [
{
"title": "Fed holds rates steady",
"url": "https://example.com/article",
"description": "Policymakers voted…",
"age": "2 hours ago",
"source": "example.com",
"breaking": false
}
]
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/search-news?q=Federal+Reserve+interest+rate+decision&count=5&freshness=pw"
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-news?q=Federal+Reserve+interest+rate+decision&count=5&freshness=pw");
Part of these workflows
This tool is one step in 4 curated multi-tool workflows - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.
- Crypto research - Pull live price, market structure, OHLC history, trending status, global market context, and recent news for a single coin in one pass.
- 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.
- IPO watch - What companies are going public? Recent S-1/IPO filings from EDGAR plus a web search for IPO news.
- 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…