# x402serps News Search API

> x402serps News Search API is a paid API for AI agents from x402serps.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-16).

Searches for recent news articles by keyword with filtering by country, language, date range, and recency — paid per call in USDC via x402

## Facts

- Endpoint: POST https://x402serps.com/api/v1/news?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-news-search-api-02c1f421
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9avK2KusPhk4fXlvkKzJ5

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 x402serps-news-search-api-02c1f421 -d '<json body>'
```

Example prompt: Search for the latest news about the Fed interest rate decision from the past week — give me up to 20 results in English for the US market.

## When to prefer this

Choose this endpoint when you need structured, ranked news search results with rich metadata (source, date, snippet) and want to filter by recency, date range, country, or language — especially in agent workflows where you want to avoid API key management and pay only per query in USDC. Prefer it over general web search endpoints when the domain is specifically news content and freshness filtering is important.

## Known failure modes

- Empty results array if query matches no indexed news articles
- Rate or quota errors if payment fails or USDC balance is insufficient
- Invalid country/language codes may return unexpected or empty results
- date range with dateFrom but missing dateTo (or vice versa) may be ignored or cause an error
- page number beyond available results returns empty results
- num values outside 1–100 may be rejected or clamped

## How this service works

x402serps: real-time News results (title, url, snippet, source, date) for one query, 10 results per $0.004 (num up to 100), with freshness/date-range filters and pagination

## Output

Returns a JSON object with the original query string, the upstream provider name, and an array of news result objects — each containing the article URL, title, publication date, source name, snippet/summary, and its ranked position in the results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "News query (alias: query)"
  },
  "gl": {
   "type": "string",
   "description": "Country code"
  },
  "hl": {
   "type": "string",
   "description": "Language code"
  },
  "num": {
   "type": "number",
   "description": "Results 1-100, default 10"
  },
  "tbs": {
   "type": "string",
   "description": "Raw tbs filter, e.g. qdr:w"
  },
  "page": {
   "type": "number",
   "description": "Result page 1-10 (pagination)"
  },
  "dateTo": {
   "type": "string",
   "description": "Custom date range end YYYY-MM-DD"
  },
  "dateFrom": {
   "type": "string",
   "description": "Custom date range start YYYY-MM-DD (with dateTo)"
  },
  "freshness": {
   "type": "string",
   "description": "Recency filter: hour, day, week, month or year"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "stablecoin regulation",
  "results": [
   {
    "url": "https://www.x402.org/",
    "date": "2 hours ago",
    "title": "Stablecoin bill advances",
    "source": "Example News",
    "snippet": "An open standard for internet-native payments over HTTP 402.",
    "position": 1
   }
  ],
  "provider": "primary"
 }
}
```

## More

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