# Agent Research Tools – Recent News Headlines

> Agent Research Tools – Recent News Headlines is a paid API for AI agents from x402-seller-pmlm.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Fetches recent deduplicated news headlines for any keyword query, returning titles, URLs, sources, publish times, and relevance scores from major outlets, GDELT, and Hacker News.

## Facts

- Endpoint: GET https://x402-seller-pmlm.onrender.com/news?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-research-tools-recent-news-headlines-0a44a5e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CFXcfVBrY7R8LCzGGREnv

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 agent-research-tools-recent-news-headlines-0a44a5e9
```

Example prompt: Can you pull the latest news headlines about 'Federal Reserve rate cuts' from the past 48 hours — give me up to 15 articles with links and sources?

## When to prefer this

Use this endpoint when an agent needs recent (1–7 days) news headlines for a specific topic from a curated set of major outlets plus GDELT and Hacker News. Prefer it over general web search when you want structured, deduplicated headline data with match scores and source metadata rather than raw search results. Ideal for news briefings, event monitoring, and research pipelines where recency and source diversity matter.

## Known failure modes

- 400 Bad Request – missing or invalid 'q' parameter (not charged)
- 422 Unprocessable Entity – no articles found for the query or target sources unreachable (not charged)
- 503 Service Unavailable – backend busy, retry later (not charged)
- Very niche or misspelled queries may return zero results (422)
- Articles older than the look-back window will not appear even if relevant

## How this service works

News search: latest news headlines on any topic from thousands of outlets, updated every 15 minutes. Use when an agent needs what happened in the last 1-7 days (companies, crypto, politics, sports, tech). Pass q (keywords). Returns deduplicated headlines with outlet, link, publish time and match score from the GDELT global news index, major outlets and Hacker News. 0.005 USDC/call; failed calls are free.

## Output

A JSON object containing the query string, article count, look-back window in hours, and an array of articles. Each article includes: title, URL, source outlet name, publish timestamp, IDF-weighted keyword match score (0–1), provider tag (rss/gdelt/hackernews), and a partialMatch flag. Also includes latency, provider status, and generation 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",
       "maxLength": 200,
       "minLength": 2,
       "description": "Keywords, e.g. 'bitcoin ETF', 'OpenAI', 'Federal Reserve rate cut'"
      },
      "hours": {
       "type": "integer",
       "maximum": 168,
       "minimum": 1,
       "description": "Look-back window in hours (default 72, max 168)"
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Max articles (default 10, max 25)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "count",
      "articles"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "hours": {
       "type": "integer"
      },
      "query": {
       "type": "string"
      },
      "terms": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "outlets": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "articles": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "title",
         "url",
         "source"
        ],
        "properties": {
         "url": {
          "type": "string"
         },
         "score": {
          "type": "number",
          "description": "0-1 keyword match (IDF-weighted)"
         },
         "title": {
          "type": "string"
         },
         "source": {
          "type": "string",
          "description": "Outlet or domain"
         },
         "provider": {
          "enum": [
           "gdelt",
           "hackernews",
           "rss"
          ],
          "type": "string"
         },
         "publishedAt": {
          "type": [
           "string",
           "null"
          ]
         },
         "partialMatch": {
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-research-tools-recent-news-headlines-0a44a5e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-seller-pmlm.onrender.com](https://www.zero.xyz/host/x402-seller-pmlm.onrender.com/llms.txt)