---
title: "Hacker News Search (x402)"
method: POST
path: "/x402/v2/hacker-news-search"
tags: ["x402"]
---

# Hacker News Search (x402)

`POST /x402/v2/hacker-news-search`

## Request

- Base URL: `https://api.strale.io`
- URL: `https://api.strale.io/x402/v2/hacker-news-search`
- Auth: none required

Search Hacker News stories and comments via the official Algolia API: title, URL, points, author, comment count, date and text, by relevance or date.

## Request body

- object
  - `sort` string: relevance (default) or date
  - `type` string: story (default), comment, or all
  - `limit` integer: Results to return, 1-30. Default: 10
  - `query` string, required: Search terms. At least 2 characters.
  - `since_days` integer: Only items created within the last N days

## Response `200`

Success

- object
  - `type` string
  - `query` string
  - `results` unknown[]
    - unknown
  - `returned` number
  - `total_results` number

## Other responses

- `402`: Payment required (x402 — pay with USDC on Base)

---

[API](https://skmtc.dev/strale/apis/strale-api-2.md) · [All operations](https://skmtc.dev/strale/apis/strale-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/strale/apis/strale-api-2/revisions/a5293878cfc6?raw)