Story Search

Story and news search across Hacker News and the open web in one call.

Overview

Story and news search across Hacker News and the open web in one call. Composite: one call runs hn-search + web-search in parallel and merges the two result lists, ranked by relevance (round-robin across sources) or by date (newest first, undated results last). Accepts the common agent story-search payload {query, type, sort, limit} — the same shape agents already send to news/story search catalogs. web-search is optional: if it fails, the response degrades to Hacker News results instead of failing the call. Use it as a story search, news search, or 'what's being discussed about X' lookup across HN and the general web.

Endpoint

Method	Endpoint	Price	Description
POST	/v1/marketplace/api/story-search	$0.02875	Invoke Story Search (Search) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/story-search \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/story-search \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Open in the marketplace