Hacker News Favorites API

A lightweight API to fetch and cache Hacker News favorites (stories or comments) for any user.

Why

The official Hacker News API from Y Combinator doesn’t include the favorites endpoint.

Features

Retrieve a user’s favorite stories or comments from Hacker News.
Handles pagination and retries with quadratic backoff.
Caches responses for 24 hours to improve performance and reduce server load.
Built with Hono and Cheerio for fast and efficient processing.

Installation

Clone the repository:

git clone https://github.com/byt3h3ad/hn-favorites-api
cd hn-favorites-api

Install dependencies:
```
pnpm install
```
Run the application:
```
pnpm dev
```

Endpoints

1. Fetch User’s Favorites

Stories:
GET /:username/stories
Comments:
GET /:username/comments

Example:

curl https://hn-favs.byt3h3ad.workers.dev/byt3h3ad/stories

2. Delete Cached Response

GET /:username/:type/delete-cache

Example:

curl https://hn-favs.byt3h3ad.workers.dev/byt3h3ad/stories/delete-cache

Response Format

Stories

[
  {
    "id": 42214331,
    "title": "What made Dostoevsky's work immortalwyounas.com",
    "url": "https://thoughts.wyounas.com/p/what-made-dostoevsky-immortal",
    "hnUrl": "https://news.ycombinator.com/item?id=42214331",
    "type": "story"
  }
]

Comments

[
  {
    "id": 22446090,
    "url": "https://news.ycombinator.com/item?id=22446090",
    "user": "bori5",
    "type": "comment"
  }
]