# AgentUtility News Search

> AgentUtility News Search is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches recent public news articles by keyword, topic, company, or ticker using GDELT and GNews, returning headlines, URLs, source domains, timestamps, and metadata.

## Facts

- Endpoint: POST https://x402.agentutility.ai/news-search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-news-search-b9db8199
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BRPqnwRyFihscVxF81Dk8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentutility-news-search-b9db8199 -d '<json body>'
```

Example prompt: Can you pull the top 10 Ethereum news headlines from the past 24 hours, with their source domains and URLs?

## When to prefer this

Choose this endpoint when you need recent news articles specifically about crypto, DeFi, Bitcoin, Ethereum, stablecoins, or broader financial markets, and want structured metadata including source domains, timestamps, and sentiment — especially when you need GDELT-quality global news coverage with a GNews fallback. Prefer this over social media search when you need journalistic sources rather than social posts.

## Known failure modes

- Query exceeds 240 characters — truncate or shorten the query string
- Hours value out of range (must be 1–168) — returns validation error
- Limit value out of range (must be 1–30) — returns validation error
- GDELT and GNews both unavailable — service returns upstream error
- No matching articles found for query — returns empty results array
- Payment not attached or insufficient USDC — x402 payment required error

## How this service works

News search API / GDELT article search / public news feed lookup. Same news handler as crypto-news, with GDELT and a GNews fallback when configured, exposed for agents searching recent articles by keyword, company, ticker, market topic, or crypto topic and returning headline URLs, source domains, timestamps, language/country metadata, and sentiment. Data only; no trading advice.

## Output

Returns a JSON object with the query used, the source backend (GDELT or GNews), the number of articles returned, and an array of article objects each containing headline text, URL, source domain, publication timestamp, language, country, and sentiment signal.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "stablecoin regulation",
  "source": "GDELT 2.1 Document API",
  "returned": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-news-search-b9db8199/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)