Unofficial Python API for Hacker News.

Build Status	Test Coverage	Version	Downloads

• Compatible with Python 2 (2.7+).
• Supports 'top', 'news2','newest' and 'best' posts
• Retrieve comments from posts (flat list for now) (story.get_comments())
• Pagination support for comments
• Handles external posts, self posts and job posts
• Get post details for any post (Story.fromid(7024626))

$ pip install HackerNews

NOTE: Do not make a lot of requests in a short period of time. HN has it's own throttling system.

from hn import HN

hn = HN()

# print the first 2 pages of newest stories
for story in hn.get_stories(story_type='newest', limit=60):
    print(story.rank, story.title)

Parameters:

Example:

from hn import HN
hn = HN()
hn.get_stories(story_type='newest', limit=10)

Parameters:

Example:

from hn import HN
hn = HN()

# get top 20 users of HN
hn.get_leaders(limit=20)

Each Story has the following properties

• rank - the rank of story on the page (keep pagination in mind)
• story_id - the story's id
• title - the title of the story
• is_self - true for self/job stories
• link - the URL it points to ('' for self posts)
• domain - the domain of the link ('' for self posts)
• points - the points/karma on the story
• submitter - the user who submitted the story ('' for job posts)
• submitter_profile - the above user's profile link (can be '')
• published_time - the published time
• num_comments - the number of comments a story has
• comments_link - the link to the comments page

Parameters:

Example:

from hn import Story
story = Story.fromid(6374031)
print story.title

Parameters:

Example:

from hn import Story
story = Story.fromid(6374031)
comments = story.get_comments()

Each Comment has the following properties

• comment_id - the comment's item id
• level - comment's nesting level
• user - user's name who submitted the post
• time_ago - time when it was submitted
• body - text representation of comment (unformatted)
• body_html - html of comment, may not be valid

Each User has the following properties

• username - user's profile name
• date_created - when the profile was created
• karma - user's e-points
• avg - user's average karma per day

See my_test_bot.py

To run the tests locally just do:

$ chmod 777 runtests.sh
$ ./runtests.sh

To run individual tests,

$ python -m unittest tests.<module name>

The tests are run on a local test server with predownloaded original responses.

If HackerNewsAPI has helped you in any way, and you'd like to help the developer, please consider donating.

- BTC: 19dLDL4ax7xRmMiGDAbkizh6WA6Yei2zP5

- Flattr: https://flattr.com/profile/thekarangoel

If you want to add any new features, or improve existing ones, feel free to send a pull request!