Skip to content
onelayer.
All tools

Tool detail

News search

Returns ranked recent news articles as JSON (title, URL, snippet, age, source, breaking flag) for a text query, with optional filters.

Categories: News

Use when

  • find recent news articles about a topic
  • get breaking headlines from the past day
  • search news filtered to a specific country

Not for

  • not full article text - title, URL and snippet only

Inputs

GET query params: q (string, required, <=400 chars); count, country, freshness all optional

Admitted input schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Results to return, 1-50 (default 10)"
    },
    "country": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional 2-letter country code (default US)"
    },
    "freshness": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional: pd, pw, pm, or py (past day/week/month/year)"
    },
    "q": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Search query (max 400 chars)"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://agent402.tools/api/search-news

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://agent402.tools/api/search-news
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z