> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hacker News

> Reference for the Tracecat Hacker News integration: registered actions, required secrets, expected inputs, and example workflow usage.

## Get item

Action ID: `tools.hackernews.get_item`

Get an item. Calls GET /v0/item/\{item\_id}.json directly.

Reference: [https://github.com/HackerNews/API](https://github.com/HackerNews/API)

### Input fields

<ParamField path="item_id" type="integer" required>
  Hacker News item ID.
</ParamField>

<ParamField path="base_url" type="string | null">
  Base URL of the Hacker News Firebase API.

  Default: `null`.
</ParamField>

## Get user

Action ID: `tools.hackernews.get_user`

Get a user. Calls GET /v0/user/\{user\_id}.json directly.

Reference: [https://github.com/HackerNews/API](https://github.com/HackerNews/API)

### Input fields

<ParamField path="user_id" type="string" required>
  Case-sensitive Hacker News username.
</ParamField>

<ParamField path="base_url" type="string | null">
  Base URL of the Hacker News Firebase API.

  Default: `null`.
</ParamField>

## Search

Action ID: `tools.hackernews.search`

Search Hacker News. Calls GET /api/v1/search directly.

Reference: [https://hn.algolia.com/api](https://hn.algolia.com/api)

### Input fields

<ParamField path="base_url" type="string | null">
  Base URL of the HN Algolia API.

  Default: `null`.
</ParamField>

<ParamField path="hitsPerPage" type="integer | null">
  Number of hits per page.

  Default: `null`.
</ParamField>

<ParamField path="numericFilters" type="string | null">
  Algolia numeric filters, such as created\_at\_i>1700000000, points>10, or num\_comments>=5.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer | null">
  Page number to retrieve.

  Default: `null`.
</ParamField>

<ParamField path="query" type="string | null">
  Full-text search query.

  Default: `null`.
</ParamField>

<ParamField path="restrictSearchableAttributes" type="string | null">
  Comma-delimited attributes to search, such as url.

  Default: `null`.
</ParamField>

<ParamField path="tags" type="string | null">
  Algolia tag filter, such as story, comment, front\_page, author\_pg, story\_1, or grouped tags.

  Default: `null`.
</ParamField>

## Search by date

Action ID: `tools.hackernews.search_by_date`

Search Hacker News by date. Calls GET /api/v1/search\_by\_date directly.

Reference: [https://hn.algolia.com/api](https://hn.algolia.com/api)

### Input fields

<ParamField path="base_url" type="string | null">
  Base URL of the HN Algolia API.

  Default: `null`.
</ParamField>

<ParamField path="hitsPerPage" type="integer | null">
  Number of hits per page.

  Default: `null`.
</ParamField>

<ParamField path="numericFilters" type="string | null">
  Algolia numeric filters, such as created\_at\_i>1700000000, points>10, or num\_comments>=5.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer | null">
  Page number to retrieve.

  Default: `null`.
</ParamField>

<ParamField path="query" type="string | null">
  Full-text search query.

  Default: `null`.
</ParamField>

<ParamField path="restrictSearchableAttributes" type="string | null">
  Comma-delimited attributes to search, such as url.

  Default: `null`.
</ParamField>

<ParamField path="tags" type="string | null">
  Algolia tag filter, such as story, comment, front\_page, author\_pg, story\_1, or grouped tags.

  Default: `null`.
</ParamField>