> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_hacker_news

# search_hacker_news

> Hacker News stories or comments matching a query: title, link, points, author, comment count and date. ₹0.12 per call; nothing matching is ₹0.

## What it does

Send a `query` and get `data[]` with `title`, `url`, `points`, `author`, `comments` (the count), `created`, `id` and `hn_url` (the discussion page), up to `limit` per call (default 20). `sort` is `relevance` or `date`; `tags` picks `story` (default), `comment`, `ask_hn`, `show_hn` or `poll`.

Use it to see what the tech crowd said about a product, a launch or a company. For Reddit use [`search_reddit`](https://parel.si/docs/tools/search_reddit.md), for the general web [`search_web`](https://parel.si/docs/tools/search_web.md); [`read_page`](https://parel.si/docs/tools/read_page.md) reads a story or its discussion.

India: Indian startups and products come up when they have been discussed there; the audience is worldwide.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | string | no | relevance (default) or date. |
| `tags` | string | no | story (default), comment, ask_hn, show_hn or poll. |
| `limit` | integer | no | How many stories, up to 50. Default 20.; max 50 |
| `query` | string | yes | The search text. |

## What drives the cost

Nothing you can turn: flat per call whatever `limit` says. Nothing matching is `class: "ok_free"`, ₹0 (the source charges nothing). Under two seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.12** per call (`cost_paise: 12`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_hacker_news"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_hacker_news"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_hacker_news","input":{"limit":10,"query":"Zomato"}}'
```

## What comes back

`data[]`. A real answer recorded during the live check of 2026-11-05 ("Zomato", five stories in 1.2 s), trimmed to three:

```json
[
  {
    "author": "a_user_71",
    "comments": 67,
    "created": "2017-05-18T06:07:47Z",
    "hn_url": "https://news.ycombinator.com/item?id=14365151",
    "id": "14365151",
    "points": 115,
    "text": null,
    "title": "Zomato security breach: 17M email addresses and hashed passwords leaked",
    "url": "http://blog.zomato.com/post/160791675411/security-notice"
  },
  {
    "author": "a_user_72",
    "comments": 37,
    "created": "2020-01-21T03:26:12Z",
    "hn_url": "https://news.ycombinator.com/item?id=22104074",
    "id": "22104074",
    "points": 59,
    "text": null,
    "title": "Uber sells food delivery business in India to Zomato",
    "url": "https://techcrunch.com/2020/01/20/uber-sells-food-delivery-business-in-india-to-zomato/"
  },
  {
    "author": "a_user_73",
    "comments": 10,
    "created": "2019-12-16T01:06:39Z",
    "hn_url": "https://news.ycombinator.com/item?id=21800107",
    "id": "21800107",
    "points": 54,
    "text": null,
    "title": "Uber in talks to sell UberEats’ India business to Zomato",
    "url": "https://techcrunch.com/2019/12/15/ubereats-india-zomato/"
  }
]
```

## Notes

- Flat per call; nothing matching is free.
- tags comment searches the comments instead of the stories.
- Links and counts only: read_page reads the story or the discussion.

## Siblings

- [`search_reddit`](https://parel.si/docs/tools/search_reddit.md) for the same on Reddit.
- [`read_page`](https://parel.si/docs/tools/read_page.md) to read a story or the discussion.
