HackerNews Search

1 credit

Search HackerNews for stories and comments.

POST/api/v1/tools/hackernews/search

Parameters

querystringrequired

Search query string.

maxResultsnumber

Maximum number of results to return. Must be a positive integer. Defaults to 100.

fieldsstring[]

Fields to include per hit. Omit for defaults: id, author, title, score, numComments, createdAt, type. Use ["*"] for all fields. Available fields: id, author, title, score, numComments, createdAt, type, text, url, hnUrl, parentId, storyId, storyTitle, storyUrl.

Response Schema

dataobject

HackerNews search result

hitsobject[]

Matching stories and comments. Default fields: id, author, title, score, numComments, createdAt, type.

countnumber

Number of hits returned

truncatedboolean

True if more results exist than were returned. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (hackernews-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/hackernews/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "LLM inference optimization",
    "maxResults": 50
  }'

Response Example

{
  "data": {
    "hits": [
      {
        "id": "40200001",
        "type": "story",
        "author": "researcher",
        "title": "New Approaches to LLM Inference Optimization",
        "score": 287,
        "numComments": 134,
        "createdAt": "2026-04-09T08:00:00.000Z"
      },
      {
        "id": "40200050",
        "type": "comment",
        "author": "ml_engineer",
        "title": null,
        "score": null,
        "numComments": null,
        "createdAt": "2026-04-09T09:30:00.000Z"
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "hackernews-search",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}