# OpenVerbs News Search

> OpenVerbs News Search is a paid API for AI agents from search.openverbs.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches live, localised Google News results for a query, returning ranked articles with title, URL, domain, source, and timestamp.

## Facts

- Endpoint: POST https://search.openverbs.com/v1/news
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-news-search-9fc12cab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tSsLhr5o8MagXN5HgGeOu

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 openverbs-news-search-9fc12cab -d '<json body>'
```

Example prompt: Search Google News for the latest articles about the US Federal Reserve interest rate decision, localised to the United States in English, and give me the top 10 results with titles, sources, and timestamps.

## When to prefer this

Choose this endpoint when you need live, ranked news articles from Google News with localisation by country and language. Prefer it over general web search endpoints when the user explicitly wants news coverage, headlines, or press articles rather than general web pages. It is especially strong for real-time current-events queries where recency and source credibility matter, and when language or geographic filtering is required.

## Known failure modes

- Empty results if the query matches no recent news articles
- Missing timestamp or source fields for some articles where Google News does not surface them
- Query too long (over 700 characters) returns a validation error
- Invalid 2-letter language code returns a validation error
- Payment failure via x402 protocol blocks the request before any search is performed
- Rate limiting or upstream Google News unavailability may return a 5xx error

## How this service works

News search: live Google News results for a query, localised by location and language. Returns ranked articles with title, URL, domain and, where available, source and timestamp. Current events and headlines for agents.

## Output

A JSON object containing a total count of matched articles and an array of ranked results, each with rank, title, URL, domain, news source name, and ISO timestamp where available.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 700,
       "minLength": 1,
       "description": "Search query."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Depth / maximum results. Defaults to 10."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      },
      "location": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 84,
  "results": [
   {
    "url": "https://www.reuters.com/markets/2026/01/15/markets-rally-inflation/",
    "rank": 1,
    "title": "Markets rally as inflation cools more than expected",
    "domain": "reuters.com",
    "source": "Reuters",
    "timestamp": "2026-01-15 09:30:00 +00:00"
   }
  ]
 }
}
```

## More

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