# Hacker News Search via The Stall x402

> Hacker News Search via The Stall x402 is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search Hacker News stories and comments by keyword, with optional filters for content type, sort order, date range, and result count — paid per call via USDC on Base.

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/hn-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-search-via-the-stall-x402-405e4cf2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_llr5X6c4LIIFu8mqygpPF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hacker-news-search-via-the-stall-x402-405e4cf2
```

Example prompt: Search Hacker News for the top 10 stories about 'LLM agents' from the past month, sorted by relevance.

## When to prefer this

Choose this endpoint when you need to search Hacker News specifically — for tech community sentiment, developer discussions, startup news, or link aggregator stories — and want a pay-per-call model with no account or API key setup. Prefer over general web search when Hacker News community perspective is the primary goal.

## Known failure modes

- Missing required 'q' parameter returns a 400 or error response
- No results found for very narrow or obscure queries
- Rate limiting or payment failure returns a 402 requiring USDC payment on Base
- Invalid enum values for sort/type/date_range return validation errors
- Limit out of range (below 1 or above 20) rejected by schema validation

## How this service works

Hacker News story and comment search via Algolia. Returns titles, scores, comment counts, authors, and URLs for posts matching the query. Filter by type (story/comment) and date range (day/week/month/year/all). Sorted by relevance by default; use sort=date for newest-first. Useful for tech news, community sentiment, or discovering discussion threads about a topic.

## Output

A list of up to 20 Hacker News items (stories or comments) matching the query, including titles, URLs, submission dates, author names, and HN item IDs. Results can be sorted by relevance or date and filtered by content type and time window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-search-via-the-stall-x402-405e4cf2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)