Hnx

Backend code that serves a RESTful API written in Python using Flask for Hnfy.

API Description

`GET /user/recommendations`

Fetches stories of interest for a particular HN user.

Parameters

id: HN username of the user.
type: Story type. Supported types are top, new, show & ask.

Response

A JSON object with a key stories whose value is an array of retrieved stories.

Example

GET /user/recommendations?id=wewake&type=top

{
  "stories": [
  {
    "author": "ladybro",
    "comments": 24,
    "points": 118,
    "time": "2018-09-11T13:05:23.000Z",
    "title": "Show HN: Mindstamp – Make Any Video Interactive in Seconds",
    "topics": [
    "Software"
    ],
    "url": "https://mindstamp.io"
  },
  {
    "author": "ristem",
    "comments": 73,
    "points": 91,
    "time": "2018-09-13T09:19:37.000Z",
    "title": "Guidelines for writing readable code",
    "topics": [
    "Programming"
    ],
    "url": "https://alemil.com/guidelines-for-writing-readable-code"
  }
]

How are the recommendations generated?

Check out the "How?" section in the README of Hnfy.

ivmarkp/hnx