created_fromstring · optionalValue supplied for created from.
format: date-time
Loading tools…
Loading tools…
Hacker News
Search public Hacker News stories, comments, jobs and polls with bounded time, type and sort filters.
Search Hacker News public content by query, relevance or recency, optional content type and optional creation-time bounds. Returns at most 50 normalized items with string IDs, author, plain text, timestamps, scores, hierarchy, external links and canonical Hacker News links. It does not promise complete historical coverage or perform unrestricted crawling.
Agents select this operation with tool ID hacker-news.search, then check its current inputs and price before a run.
created_fromstring · optionalValue supplied for created from.
format: date-time
created_tostring · optionalValue supplied for created to.
format: date-time
limitinteger · optionalValue supplied for limit.
minimum: 1 · maximum: 50
querystring · requiredSearch terms used to find relevant records.
minLength: 1 · maxLength: 500
sortstring · optionalValue supplied for sort.
enum: relevance, date
typestring · optionalValue supplied for type.
enum: all, story, comment, job, poll
Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.
Connect your first agent to receive $1 trial credit.
captured_atstringReturned captured at value.
itemsarrayReturned items value.
returned_resultsnumberReturned returned results value.
sortstringReturned sort value.
typestringReturned type value.
Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.
{
"tool_id": "hacker-news.search",
"input": {
"sort": "relevance",
"type": "story",
"limit": 5,
"query": "My YC app: Dropbox - Throw away your USB drive"
}
}{
"sort": "relevance",
"type": "story",
"items": [
{
"id": "8863",
"type": "story",
"state": "available",
"title": "My YC app: Dropbox - Throw away your USB drive",
"author": "dhouston",
"points": 104,
"created_at": "2007-04-04T19:55:01.000Z",
"source_url": "https://news.ycombinator.com/item?id=8863",
"comment_count": 71
}
],
"captured_at": "2026-08-21T00:00:00.000Z",
"returned_results": 1
}invalid_input: The query, content type, time range, sort or result limit was outside the bounded Hacker News search contract.example: {"query":"My YC app: Dropbox - Throw away your USB drive","type":"story","sort":"relevance","limit":5}