10 calls per IP
The free relay allows 10 news searches per IP in total. After that you pay $0.003 per call in USDC on Base. This is separate from the 25 free web searches and from extract/render trials.
Free tier · 10 calls per IP · then $0.003 on Base
Get recent news articles for a topic, company or event as clean JSON: headline, URL, snippet, source domain and publish date. 10 free news searches per IP on the free relay (lifetime, they do not reset), then $0.003 per call on the direct x402 API. No account, plan or API key.
POST https://relay.agentsearchhq.com/v1/news
A news-focused search, not a general web SERP. Use it when recency matters: product launches, market moves, policy, outages.
The free relay allows 10 news searches per IP in total. After that you pay $0.003 per call in USDC on Base. This is separate from the 25 free web searches and from extract/render trials.
Each article includes title, URL, snippet, domain and publish date when known. Request 1–10 results (default 5).
Works on the hosted MCP (agentsearch_news_search), @agentsearchhq/agentsearch-mcp 1.8.7+, the framework packages and n8n 0.7.5+ (free when no wallet is set).
JSON in, JSON out. Schema: news OpenAPI. Live relay also lists this route at relay.agentsearchhq.com/openapi.json.
| Field | Default | Notes |
|---|---|---|
query | required | Topic, company, person or event, at least 2 characters. |
max_results | 5 | How many articles to return, 1–10. |
curl -s -X POST https://relay.agentsearchhq.com/v1/news \
-H 'content-type: application/json' -H 'x-agent-client: curl-docs/news' \
-d '{"query":"Federal Reserve interest rate","max_results":5}'
Paid path (after the free allowance, or with AGENTSEARCH_MODE=paid): POST https://api.agentsearchhq.com/x402/v1/news at $0.003. Wallet setup: wallet-setup. Filters (freshness, country, language, domains) are available on the paid API.
Web search · Search + Read · Screenshots · Hosted MCP · Free screenshots blog post · Pricing