3 min read
Hacker News Daily API

Hackernews logo.png

Hacker News Daily API

REST API built with TypeScript and Express for HN Daily

About

If it is not yet obvious, I am obviously a Hacker News addict. I regularly visit the site to get my daily dose of dopamine. HN Daily gives the daily top stories from Hacker News. These are nicely sorted by day, month, as well as year. This is my attempt to create a simple Express web application using TypeScript so that building bots or frontends for this will be simpler.

API Reference

Show Homepage

GET /
ParameterTypeDescription
nonenoneHomepage

Get today

GET /day
ParameterTypeDescription
nonenoneDefaults to show today’s top stories

Get specific date

GET /date/${date}
ParameterTypeDescription
datestringRequired. Date in YYYY-MM-DD format.

Get this month

GET /month
ParameterTypeDescription
nonenoneDefaults to show this month’s top stories.

Get specific month

GET /month/${date}
ParameterTypeDescription
datestringRequired. Date in YYYY-MM format.

Run Locally

Clone the project

git clone https://github.com/byt3h3ad/hndailyapi.git

Go to the project directory

cd hndailyapi

Install dependencies

pnpm install

Start the server

pnpm dev

Roadmap

-~~ Add month support~~

  • Add year support (?)

Tech Stack

ExpressJS, Typescript.

Cheerio for manipulating and parsing HTML documents.

Usage/Examples

GET /day/2024-04-14
GET /month/2024-04