# aiworker-data News Search

> aiworker-data News Search is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search recent crypto and finance news headlines by keyword, filtered to a configurable time window, returning titles, summaries, links, and publisher info.

## Facts

- Endpoint: POST https://aiworker.duckdns.org/v1/news/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-data-news-search-9ea2aef3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4jcktdwec8CuQCBezngGn

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 aiworker-data-news-search-9ea2aef3 -d '<json body>'
```

Example prompt: Search for news headlines mentioning 'Base ETF' published in the last 24 hours and show me the top 10 results with summaries and links.

## When to prefer this

Use this endpoint when you need keyword-searchable, time-windowed crypto and finance news headlines with per-item summaries and source attribution, paid per call in USDC. Prefer it over generic web search when you need structured, machine-readable news data with freshness metadata and no scraping overhead, especially within the aiworker-data ecosystem where the same session may also call DeFi yield, token, or Polymarket routes.

## Known failure modes

- Query string too short (< 2 chars) or too long (> 120 chars) returns validation error
- Hours value outside 1–168 range returns validation error
- Limit value outside 1–50 range returns validation error
- No matching headlines returns empty items array with feed stats
- Payment not included or insufficient USDC causes 402 rejection
- Upstream news feed unavailable may return stale or reduced result set

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

Returns a JSON object containing: a list of news items (each with title, summary, link, publisher, and ISO timestamp), total count of fresh vs stale feed entries, the echoed query string, the time window used, a generated_at timestamp, and disclaimer/attribution strings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "integer",
   "default": 48,
   "maximum": 168,
   "minimum": 1,
   "description": "Only headlines published within the last N hours (default 48)."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum headlines to return (default 20)."
  },
  "query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "Search words, matched whole-word and case-insensitively against headline titles and summaries."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "feeds": {
   "fresh": 11,
   "stale": 1,
   "total": 12
  },
  "items": [
   {
    "link": "https://www.coindesk.com/markets/2026/09/10/bitcoin-etf-inflows",
    "title": "Bitcoin ETF inflows hit a monthly high",
    "summary": "Spot bitcoin ETFs took in … on Wednesday, the largest daily figure since …",
    "published": "2026-09-10T14:02:00.000Z",
    "publisher": "CoinDesk"
   }
  ],
  "query": "bitcoin etf",
  "disclaimer": "…",
  "attribution": "…",
  "generated_at": "2026-09-11T00:00:00.000Z",
  "window_hours": 48
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-data-news-search-9ea2aef3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)