cheeaun / node-hnapi

Unofficial Hacker News API

Hacker News (unofficial) API

Yet another unofficial API for Hacker News. Currently being used by my other project. Feel free to fork and contribute.

• API (Cloudflare CDN, faster response time): http://api.hackerwebapp.com/
• API Documentation: https://github.com/cheeaun/node-hnapi/wiki/API-Documentation

---

☕️ Buy me a coffee ☕ (server, domain & maintenance)

---

🚧 PLEASE READ THIS 🚧

If you are planning to scrape a huge amount of posts or (historical) data from HN, please don't use this API. Use the official Hacker News API or HN Search API instead.

---

Quick Start

1. git clone this repo.
2. cd to repo folder.
3. Optionally download, install and start redis.
4. npm i
5. npm start
6. Load localhost:1337 in your web browser.

Example

http://api.hackerwebapp.com/news?page=2

Configuration

HNapi uses dotenv for configuration.

• PORT - (default: 1337) Server port
• CACHE_EXP - (default: 600) Cache expiry in seconds
• LOG_REFERER - (default: false) Logs referers
• LOG_USERAGENT - (default: false) Logs user-agent strings
• CACHE_MEMORY - (default: true) Use in-memory caching
• CACHE_STORE - (redis, default: none) Specify the cache store
• CACHE_SERVER - HOST:PORT for Redis server

License

Licensed under the MIT License.

Other APIs

• The official Hacker News API
• http://hn.algolia.com/api
• http://api.ihackernews.com/
• http://hndroidapi.appspot.com/
• http://www.hnsearch.com/api
• https://github.com/Boxyco/hackernews-api