You can access the Hacker News Front-Page Snapshot programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

1import { ApifyClient } from 'apify-client';
2
3// Initialize the ApifyClient with your Apify API token
4// Replace the '<YOUR_API_TOKEN>' with your token
5const client = new ApifyClient({
6    token: '<YOUR_API_TOKEN>',
7});
8
9// Prepare Actor input
10const input = {
11    "searchKeywords": [
12        "source-backed signal",
13        "buyer fit"
14    ],
15    "taskIntent": "buyer-ready-product-run",
16    "sourceMode": "startUrls",
17    "outputMode": "buyer-ready-records",
18    "startUrls": [
19        {
20            "url": "https://news.ycombinator.com/"
21        }
22    ],
23    "overallTimeoutSecs": 900,
24    "requestTimeoutSecs": 30,
25    "maxRequestRetries": 2,
26    "sinceLastRun": false,
27    "deltaMode": true
28};
29
30// Run the Actor and wait for it to finish
31const run = await client.actor("zentrafoundry/ugly-website-ai-agent-connector").call(input);
32
33// Fetch and print Actor results from the run's dataset (if any)
34console.log('Results from dataset');
35console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
36const { items } = await client.dataset(run.defaultDatasetId).listItems();
37items.forEach((item) => {
38    console.dir(item);
39});
40
41// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

HN front-page HTML — not an AI-agent connector API in JavaScript

The Apify API client for JavaScript is the official library that allows you to use Hacker News Front-Page Snapshot API in JavaScript or TypeScript, providing convenience functions and automatic retries on errors.

Install the apify-client

$npm install apify-client

Other API clients include:

Hacker News Front-Page Snapshot API in Python

Hacker News Front-Page Snapshot API through CLI

Hacker News Front-Page Snapshot OpenAPI definition

Hacker News Front-Page Snapshot API

Hacker News Front Page Scraper | JSON Export

trisert/hacker-news-front-page

Scrape the Hacker News front page into structured JSON (stories + URLs). Pay per result. Ideal for news aggregators.

Nicola Destro

Hacker News Story Stats

brunofin/hacker-news-story-stats

Fetch Hacker News story intelligence from the official Algolia HN Search API: front-page stories or query search with title, points, comments, author, and URL metadata.

Bruno Finger

Hacker News Story Snapshot

zentrafoundry/social-trend-radar-reddit-x-youtube

HN Algolia stories for OpenAI. Reddit, X and YouTube HTML 403 from this IP. $0.01 / story.

Zentra

Hacker News Scraper: Front Page, Search & Ask

cynix_dev/hacker-news-scraper

Scrape Hacker News stories, front page, and keyword search via the Algolia API. Get title, URL, points, comments. No API key.

Cynix Dev

Hacker News Scraper

sweet_rebel/hacker-news-scraper

Rajat Sharda

Hacker News Scraper

klondikeking/hacker-news-scraper

Pierrick McD0nald

Hacker News Scraper

rl1987/hacker-news-scraper

Scrapes Hacker News by search, user, listing (front page/new/ask/show/jobs/best), or specific threads.

R.L.

Hacker News Top Stories

reverberant_equality/hn-top-stories

Scrape top stories from Hacker News by section. Extract story titles, URLs, points, authors, and comment counts from the front page, new, ask, show, or jobs sections.

Jordan C

Hackernews Scraper

koralisx/hackernews-scraper

Scrape Hacker News front page stories

Koralis X

Hacker News Web Scraper

slate_spool/hacker-news-web-scraper

Scrape Hacker News (news.ycombinator.com) for stories, comments, and user profiles. Returns structured data including title, URL, score, author, timestamp, comment count, and full comment trees. Perfect for trend analysis, tech market research, and content monitoring.