HackerNews

How to Use This API

1. Get Top Stories (IDs only)

https://hacker-news.firebaseio.com/v0/topstories.json

2. Get a Specific Story

https://hacker-news.firebaseio.com/v0/item/12345678.json

3. New, Best, Ask, Show, Jobs

https://hacker-news.firebaseio.com/v0/newstories.json
https://hacker-news.firebaseio.com/v0/beststories.json
https://hacker-news.firebaseio.com/v0/askstories.json
https://hacker-news.firebaseio.com/v0/showstories.json
https://hacker-news.firebaseio.com/v0/jobstories.json

4. Get User Profile

https://hacker-news.firebaseio.com/v0/user/jl.json

5. JavaScript — Top 5 Headlines

async function topHeadlines() {
  const ids = await (await fetch(
    'https://hacker-news.firebaseio.com/v0/topstories.json'
  )).json();
  
  const top5 = ids.slice(0, 5);
  const stories = await Promise.all(
    top5.map(id => fetch(
      `https://hacker-news.firebaseio.com/v0/item/${id}.json`
    ).then(r => r.json()))
  );
  
  stories.forEach((s, i) => {
    const score = s.score;
    const title = s.title;
    const by = s.by;
    const comments = s.descendants ?? 0;
    console.log(`${i + 1}. [${score} pts] ${title}`);
    console.log(`   by ${by} — ${comments} comments`);
  });
}

topHeadlines();

6. Python — HN Job Board

import requests

def hacker_news_jobs():
    job_ids = requests.get(
        'https://hacker-news.firebaseio.com/v0/jobstories.json'
    ).json()
    
    print("Recent Hacker News job postings:")
    for job_id in job_ids[:10]:
        job = requests.get(
            f'https://hacker-news.firebaseio.com/v0/item/{job_id}.json'
        ).json()
        title = job.get('title', 'Untitled')
        url = job.get('url', '')
        score = job.get('score', 0)
        print(f'  • {title}')
        if url:
            print(f'    {url}')
        print(f'    Score: {score}')

hacker_news_jobs()