Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including hackernews-api with all npm packages installed. Try it out:

var hackernewsApi = require("hackernews-api")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

hackernews-api v1.0.0

Javascript wrapper for accessing the official Hacker News API v0

HackerNews-API

Overview

HackerNews-API is a Node.js wrapper for accessing v0 of the official Hacker News API.

Installation

The current production release of HackerNews-API is available through npm:

npm install hackernews-api

Usage

> var hn = require('hackernews-api');
> hn.getItem(8863);
{
  by : "dhouston",
  descendants : 71,
  id : 8863,
  kids : [ 8952, 9224, 8917, 8884, 8887, 8943, 8869, 8958, 9005, 9671, 8940, 9067, 8908, 9055, 8865, 8881, 8872, 8873, 8955, 10403, 8903, 8928, 9125, 8998, 8901, 8902, 8907, 8894, 8878, 8870, 8980, 8934, 8876 ],
  score : 111,
  time : 1175714200,
  title : "My YC app: Dropbox - Throw away your USB drive",
  type : "story",
  url : "http://www.getdropbox.com/u/2/screencast.html"
}
> hn.getUser('wcember');
{ about: 'programmer, actuary, consultant.<p>williamcember.com\ngithub.com&#x2F;
wcember\n@wcember',
  created: 1382846640,
  delay: 0,
  id: 'wcember',
  karma: 4,
  submitted: [ 9106838, 7979403, 6638253 ] }

API

getItem

  • Accepts: A string or number representing an item ID.
  • Returns: An object containing the item's properties if the item exists, null otherwise.

getUser

  • Accepts: A string representing a user.
  • Returns: An object containing the user's properties if the user exists, null otherwise.

getMaxItem

  • Returns: The largest item ID (number).

getTopStories

  • Returns: An array containing the ID's of up to the 500 top stories.

getNewStories

  • Returns: An array containing the ID's of up to the 500 latest stories.

getAskStories

  • Returns: An array containing the ID's of up to the 200 latest Ask HN stories.

getShowStories

  • Returns: An array containing the ID's of up to the 200 latest Show HN stories.

getJobStories

  • Returns: An array containing the ID's of up to the 200 latest jobs stories.

getUpdates

  • Returns: An object containing the the following attributes:
    • items: The ID's of the latest items changed.
    • profiles: The usernames of the latest profiles changed.
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free