Hacker News·Hacker News

Search stories

/searchsync$0.002 / call

Full-text search over Hacker News. Returns stories (or comments) with title, URL, points, comment count, author and date — sorted by relevance, or by date with recent=true.

Input

querystringrequired
Search terms.
typestring
What to search (default "story").
story, comment, ask_hn, show_hn
recentboolean
Sort newest first instead of by relevance.
limitinteger
Max results (default 20).

Field	Type	Required	Description
query	string	yes	Search terms.
type	string (story, comment, ask_hn, show_hn)	—	What to search (default "story").
recent	boolean	—	Sort newest first instead of by relevance.
limit	integer	—	Max results (default 20).

Run it

curl -s https://sooma.dev/v1/run \ -H "Authorization: Bearer $SOOMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"hackernews","endpoint":"/search","input":{"query":"MCP servers","limit":5}}'

Or ask your agent: it will call inspect for this schema and run it over MCP.