Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Wrapper around HNSearch REST API
JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
test
.gitignore
.travis.yml
LICENSE-MIT
README.md
index.js
package.json

README.md

build status

node-hnsearch

node-hnsearch is a thin wrapper around the HNSearch REST API. Since node-hnsearch is such a thin wrapper, consulting the documentation provided by HNSearch is highly advised.

Installation

Download

$ npm install hnsearch

Or install via git clone:

$ git clone git://github.com/jharding/node-hnsearch.git
$ cd node-hnsearch
$ npm install

Require

var hnsearch = require('hnsearch');

API

hnsearch.submissions(query, cb)

hnsearch.comments(query, cb)

hnsearch.users(query, cb)

Use for querying submissions, comments, and users, respectively, against HNSearch's search API. query is the object containing the key-value pairs that the query string will be composed of. cb is the callback function that will be called when the response from HNSearch is received. It should support a (err, response) signature.

Details about the query fields and the response object can be found on the HNSearch API website.

Example

var hnsearch = require('hnsearch');

hnsearch.submissions({ q: 'javascript semicolons' }, function(err, response) {
  if (err) { process.exit(1); }

  console.log('Comments about semicolons and javascript!');
  response.results.forEach(function(result) { 
    console.log(result.item.text); 
  });
});

Testing

$ cd node-hnsearch
$ npm test

Issues

Found a bug? Create an issue on GitHub.

https://github.com/jharding/node-hnsearch/issues

Versioning

For transparency and insight into the release cycle, releases will be numbered with the follow format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

  • Breaking backwards compatibility bumps the major
  • New additions without breaking backwards compatibility bumps the minor
  • Bug fixes and misc changes bump the patch

For more information on semantic versioning, please visit http://semver.org/.

License

Copyright (c) 2013 Jake Harding
Licensed under the MIT License.

Something went wrong with that request. Please try again.