sideko_hacker_news typescript

Hacker News makes the public their data available in near real time.

The v0 API is essentially a dump of our in-memory data structures. We know, what works great locally in memory isn't so hot over the network. Many of the awkward things are just the way HN works internally... It's not the ideal public API, but it's the one we could release in the time we had

This documentation and SDK libraries have been generated by Sideko which has no affiliation with Hacker News. Everything you see is generated from an OpenAPI specification.

Install and try the free beta SDK generator on our Github.

Authentication

import { Client } from 'sideko_hacker_news';
const client = new Client();

get_ask_story_ids

List the latest Ask HN story IDs. Will return maximum 200 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getAskStoryIds({})

get_best_story_ids

List the best hacker news story IDs. Will return maximum 500 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getBestStoryIds({})

get_item

Stories, Comments, Jobs, Ask HNs and even Polls are all considered items, with slightly different structures (see the examples).

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getItem({"id": 123})

get_job_story_ids

List the latest Job story IDs. Will return maximum 200 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getJobStoryIds({})

get_max_item_id

The current largest item ID. Walking backwards from here allows you to list all items avialable through the API.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getMaxItemId({})

get_new_story_ids

List the top hacker news story IDs. Will return maximum 500 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getNewStoryIds({})

get_show_story_ids

List the latest Show HN story IDs. Will return maximum 200 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getShowStoryIds({})

get_top_story_ids

List the top hacker news story IDs. Will return maximum 500 IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getTopStoryIds({})

get_updates

List recently updated item IDs and profile IDs.

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getUpdates({})

get_user

Retrieves user metadata given the user ID (HN username).

Documentation & SDKs generated by Sideko from OpenAPI. Install and try the free beta SDK generator on our Github.

const response = await client.getUser({"id": "string"})