# x402.onchainexpat.com News Search

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

Search and retrieve recent news articles by keyword query, with options for result count and sorting

## Facts

- Endpoint: POST https://x402.onchainexpat.com/api/x402-tools/news/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-onchainexpat-com-3b13b1e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hw-mAkx2MLhaNPWnbbcXN

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 x402-onchainexpat-com-3b13b1e8 -d '<json body>'
```

Example prompt: Search for the 10 most relevant news articles about Bitcoin ETF approval and return them sorted by relevancy.

## When to prefer this

Use this endpoint when an agent needs to retrieve recent news articles from across the web for a specific keyword or topic, especially when you need metadata like author, source, image, and publish date alongside article links. Prefer over general web search when structured news article metadata is required.

## Known failure modes

- Empty results if query matches no indexed articles
- Cached responses may return stale articles
- Result count may be less than requested limit if insufficient articles exist
- Payment failure if USDC balance is insufficient for the $0.01 per-call fee
- Invalid sort_by value may cause error or default behavior

## How this service works

Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol

## Output

Returns a JSON object with a count of results, the original query string, a cached flag, and an array of articles each containing URL, title, author, source name, image URL, short description, and published timestamp.

## Example request

```json
{
 "limit": 10,
 "query": "artificial intelligence",
 "sort_by": "relevancy"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max articles (default 10, max 100). Aliases: 'page_size', 'pageSize'"
  },
  "query": {
   "type": "string",
   "description": "Search query. Alias: 'q'"
  },
  "sort_by": {
   "type": "string",
   "description": "relevancy, popularity, or publishedAt (default). Alias: 'sortBy'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "cached": {
   "type": "boolean"
  },
  "articles": {
   "type": "array"
  },
  "total_results": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-onchainexpat-com-3b13b1e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onchainexpat.com](https://www.zero.xyz/host/x402.onchainexpat.com/llms.txt)