Skip to content
telipot
telipot
Join the waitlistSign in

Hacker News stories by query, ranked by relevance.

Search Hacker News stories and comments

Job news.search

Your AI asks

checks the price first
telipot run hackernews.news.search \
  --input-json '{"query":"agent tools","hitsPerPage":2}' \
  --quote

Price

Free
Priced· before it runs

hackernews.news.search

FreeNo account

Whose account it uses

No account neededSelected identity for this example

What it sends

{
  "query": "agent tools",
  "hitsPerPage": 2
}

No credential is needed for this call.

What it costs

Free

no charge from the provider

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run hackernews.news.search \
  --input-json '{"query":"agent tools","hitsPerPage":2}'

query

string · required

Example: "agent tools"

tags

string · one of "story", "comment" · default "story"

hitsPerPage

integer · 1 to 50 · default 10

Example: 2

hits

object[]

hitsPerPage

integer

nbHits

integer

nbPages

integer

page

integer

params

string

processingTimeMS

integer

query

string

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "required": [
    "hits",
    "hitsPerPage",
    "nbHits",
    "nbPages",
    "page",
    "query"
  ],
  "properties": {
    "hits": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "objectID",
          "author",
          "created_at",
          "created_at_i",
          "_tags"
        ],
        "properties": {
          "objectID": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "points": {
            "type": [
              "integer",
              "null"
            ]
          },
          "num_comments": {
            "type": [
              "integer",
              "null"
            ]
          },
          "story_id": {
            "type": "integer"
          },
          "story_text": {
            "type": "string"
          },
          "comment_text": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "created_at_i": {
            "type": "integer"
          },
          "updated_at": {
            "type": "string"
          },
          "_tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "hitsPerPage": {
      "type": "integer"
    },
    "nbHits": {
      "type": "integer"
    },
    "nbPages": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "params": {
      "type": "string"
    },
    "processingTimeMS": {
      "type": "integer"
    },
    "query": {
      "type": "string"
    }
  }
}

A real answer

examples/hackernews.news.search.json

{
  "hits": [
    {
      "_tags": [
        "story",
        "author_user"
      ],
      "author": "user",
      "created_at": "2026-07-09T15:45:17Z",
      "created_at_i": 1783611917,
      "num_comments": 40,
      "objectID": "48847834",
      "points": 96,
      "story_id": 48847834,
      "story_text": "Hey HN! We built a browser-based agent that runs inside an authenticated web app, watches how the app calls its own APIs, and automatically turns those into agent tools. You can think of it as an auto…",
      "title": "Show HN: Reverse-engineering web apps into agent tools",
      "updated_at": "2026-07-20T14:39:08Z"
    },
    {
      "_tags": [
        "story",
        "author_user"
      ],
      "author": "user",
      "created_at": "2026-03-24T06:31:15Z",
      "created_at_i": 1774333875,
      "num_comments": 8,
      "objectID": "47499242",
      "points": 50,
      "story_id": 47499242,
      "title": "Fast regex search: indexing text for agent tools",
      "updated_at": "2026-04-09T02:11:45Z",
      "url": "https://cursor.com/blog/fast-regex-search"
    }
  ],
  "hitsPerPage": 2,
  "nbHits": 69733,
  "nbPages": 500,
  "page": 0,
  "params": "query=agent+tools&hitsPerPage=2&advancedSyntax=true&analyticsTags=backend",
  "processingTimeMS": 36,
  "query": "agent tools"
}