{"uid":"cap_sRpSR4ymIqxz7jMJHXvqm","slug":"companyfacts-dev-hacker-news-search-api-c95cd61a","name":"companyfacts.dev Hacker News Search API","description":"Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.","url":"https://companyfacts.dev/x402/v1/hacker-news?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"query":{"type":"string"},"date_from":{"type":"string"},"story_ids":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mode":"search","count":1,"items":[{"id":8863,"url":"http://www.getdropbox.com/u/2/screencast.html","type":"story","title":"My YC app: Dropbox - Throw away your USB drive","author":"dhouston","domain":"getdropbox.com","points":104,"source":"algolia","created_at":"2007-04-04T19:16:40Z","verify_url":"https://news.ycombinator.com/item?id=8863","num_comments":71}],"notes":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I4C5hRhNqwTBfHJMJvWZ9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve Hacker News stories by keyword query, date range, or specific story IDs via a paid x402 endpoint.","exampleAgentPrompt":"Search Hacker News for stories about 'large language models' posted after January 1, 2024 and give me the titles, authors, point counts, and URLs.","exampleUseCases":[{"title":"Track HN buzz around a startup","prompt":"Search Hacker News for any posts mentioning 'Anthropic' from 2023 onwards and show me the titles, points, and number of comments for each one."},{"title":"Research HN reaction to a technology","prompt":"Find Hacker News stories about 'WebAssembly' — I want to see the most discussed posts with their point counts, authors, and links."},{"title":"Fetch a specific HN story by ID","prompt":"Can you pull up the Hacker News story with ID 8863 and give me its title, URL, author, and how many comments it has?"}],"resultDescription":"Returns a JSON object with a mode field (e.g. 'search'), a count of results, and an array of story items each containing: numeric ID, URL, type, title, author handle, domain, point score, source (e.g. 'algolia'), creation timestamp (ISO 8601), a verify URL linking back to news.ycombinator.com, and number of comments. Also includes a notes array for any metadata about the response.","failureModes":["Ambiguous or missing query returns zero results","date_from value in wrong format returns an error","story_ids referencing deleted or non-existent stories returns empty items","Rate limiting or payment failure returns 402 or access denied","Very broad queries may return truncated or paginated results without clear indication"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable metadata about Hacker News stories — including point counts, comment counts, authors, and timestamps — especially when filtering by keyword or date. Prefer it over scraping HN directly or using the Firebase HN API when you need full-text search capability with parsed fields and are comfortable with per-call micropayment via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:43.370Z","isFirstParty":false,"canonicalSlug":"companyfacts-dev-hacker-news-search-api-c95cd61a"}