# News Search API (Recent Headlines by Topic, Company, Person, or Token)

> News Search API (Recent Headlines by Topic, Company, Person, or Token) is a paid API for AI agents from api.agent-data.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-14).

Search recent news articles by keyword query with optional filters for language, country, and time window, returning headline, source, link, and publish time.

## Facts

- Endpoint: GET https://api.agent-data.workers.dev/api/v1/news/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-search-api-recent-headlines-by-topic-company-person-or-token-5170cca6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yLcsspDcuNCm__PWp-Eeq

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 news-search-api-recent-headlines-by-topic-company-person-or-token-5170cca6
```

Example prompt: Can you find me the latest news about Solana ETFs from the past 24 hours — give me up to 10 results in English?

## When to prefer this

Choose this endpoint when you need fast, recent news search across any topic, company, person, or crypto token with flexible time filtering (last hour, day, or week). It is ideal for agents doing real-time research, due diligence, or market monitoring without needing a dedicated news API key. Prefer it over scraping or general web search when you want structured, pre-parsed headline data with source attribution and publish times.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- Invalid 'when' format (not 1h/1d/7d) may return no results or an error
- Unsupported language or country code may yield empty results
- Limit values outside 1–100 range are rejected by schema validation
- Queries about very niche or obscure topics may return zero results
- Rate limiting or payment failure (x402) may block the request

## How this service works

Search recent news about any topic, company, person or token: headline, source, link, publish time. Filter by language, country and age (when=1h, 1d, 7d).

## Output

A JSON object containing the original query string, the data source (google_news), a count of returned items, and an array of news items each with a title, source name, article link, and RFC-formatted publish timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string"
      },
      "lang": {
       "type": "string"
      },
      "when": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "country": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "link": "https://news.google.com/...",
    "title": "Solana ETF sees record inflows",
    "source": "Reuters",
    "published": "Tue, 03 Nov 2026 12:00:00 GMT"
   }
  ],
  "query": "solana ETF",
  "source": "google_news"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-search-api-recent-headlines-by-topic-company-person-or-token-5170cca6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agent-data.workers.dev](https://www.zero.xyz/host/api.agent-data.workers.dev/llms.txt)
