randome / 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: http://node-hnapi.herokuapp.com/
• API Documentation: https://github.com/cheeaun/node-hnapi/wiki/API-Documentation

NOTE: 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 or memcached.
4. npm install
5. node server.js
6. Load localhost in your web browser.

Configuration

HNapi uses nconf for configuration, which can be done via the config.json file, environment variables and command-line arguments.

• port - (default: 80) 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
  • store - (memcached | redis, default: none) Specify the cache store
  • options - Options for specified cache store
    • servers - HOST:PORT for memcached server
    • url - redis://USERNAME:PASSWORD@HOST:PORT for redis server
    • debug - (default: false) Allows debugging (only for redis store)
• papertrail - for logging with Papertrail
  • host
  • port
  • hostname (optional) - host name for the server
• universal_analytics - for logging with Google Analytics' Universal Analytics' Measurement Protocol
  • tid - tracking ID

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