Skip to content
onelayer.
All tools

Tool detail

AgentUtility.ai

Searches Hacker News (via the Algolia HN index) for stories, comments or polls matching a query, filterable by author, minimum points and date range.

Categories: News

Use when

  • search Hacker News for a startup or topic
  • find Show HN launches or YC-related discussion
  • track a specific HN author's posts or comments

Not for

  • not other news sources - Hacker News/Algolia index only

Inputs

POST JSON body: query (string, required); author, min_points, since, until, sort (relevance/date), type (story/comment/poll), limit (1-20, default 10) all optional.

Admitted input schema

{
  "type": "object",
  "properties": {
    "author": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Filter to a specific HN username (e.g. 'pg', 'dang')."
    },
    "limit": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Max hits to return. 1-20. Default 10."
    },
    "min_points": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Minimum points (upvotes) floor. Comments don't have points; using this implicitly filters to stories."
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Free-text search query (matches title, body, author, URL)."
    },
    "since": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Lower bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp."
    },
    "sort": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "relevance",
        "date"
      ],
      "description": "'relevance' (default, popularity-weighted) or 'date' (most-recent-first)."
    },
    "type": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "story",
        "comment",
        "poll"
      ],
      "description": "Restrict to a single HN item type. Omit to include all types."
    },
    "until": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Upper bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://x402.agentutility.ai/hacker-news-search

Payment

Protocol
x402
Listed price
0.001 USDC per request 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
POST https://x402.agentutility.ai/hacker-news-search
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z