Live-JSON ohne Schlüssel: Hacker News API nutzen

Wie nutzt man die Hacker News API?

Jede Frage dazu, wie man die Hacker News API nutzen soll, läuft auf einen von zwei kostenlosen Hosts hinaus: hacker-news.firebaseio.com/v0/ liefert Live-Items, Nutzerprofile und Ranglisten von Stories, und hn.algolia.com/api/v1/ liefert die Volltextsuche. Beide geben reines JSON über HTTPS zurück, beide akzeptieren anonyme Anfragen, und keiner von beiden vergibt API-Schlüssel oder akzeptiert ein Token. Greifen Sie zu Firebase, wenn Sie bereits eine Item-ID kennen oder die aktuelle Startseite wollen, und zu Algolia, wenn Sie ein Stichwort und keine ID haben.

Was gibt die Firebase API für ein einzelnes Item zurück?

Die Firebase API gibt pro Item ein flaches JSON-Objekt von /v0/item/<id>.json zurück, und id ist das einzige Feld, das jedes Item trägt. Die README von HackerNews/API listet deleted, type, by, time, text, dead, parent, poll, kids, url, score, title, parts und descendants als optionale Felder, wobei type einen der Werte "job", "story", "comment", "poll" oder "pollopt" annimmt. Schreiben Sie Ihren Parser gegen id plus alles Weitere, was Sie vorfinden, denn ein comment trägt parent und text, wo eine story url, score und descendants trägt.

curl "https://hacker-news.firebaseio.com/v0/item/8863.json?print=pretty"

{
  "by": "dhouston",
  "descendants": 71,
  "id": 8863,
  "kids": [9224, 8917, 8884, 8887],
  "score": 104,
  "time": 1175714200,
  "title": "My YC app: Dropbox - Throw away your USB drive",
  "type": "story",
  "url": "http://www.getdropbox.com/u/2/screencast.html"
}

Das ist die Live-Antwort für Item 8863, wobei das kids-Array auf vier IDs gekürzt ist; das echte enthält 33. time ist ein Unix-Zeitstempel in Sekunden, descendants zählt den gesamten Kommentarbaum, und kids enthält nur die direkten Antworten, sodass das Durchlaufen eines vollständigen Threads bedeutet, sich mit je einer Anfrage rekursiv durch kids zu arbeiten.

Welche Endpunkte der Hacker News API gibt es?

Die Firebase API stellt zehn Pfade bereit, alle per GET, alle mit .json am Ende. Jeder Listenpfad gibt ein Array von Item-IDs zurück und nicht die Items selbst, sodass ein Listenabruf eine Anfrage plus eine Anfrage pro ID kostet, die Sie anschließend auflösen.

Die dokumentierten Größen sind Obergrenzen, keine festen Längen. Abgefragt am 10. September 2026 gab /v0/topstories.json die vollen 500 IDs zurück, während /v0/askstories.json 28 zurückgab und /v0/maxitem.json 49.649.544 meldete. IDs laufen fortlaufend ab Item 1, einer story mit dem Titel "Y Combinator", gepostet vom Nutzer pg mit einem time von 1160418111, sodass ein Crawler das gesamte Korpus durch Hochzählen durchlaufen kann. Genau diese fortlaufende ID macht auch die Hacker-News-Statistiken, die Sie aus denselben Endpunkten ziehen, nachprüfbar statt zweitrangig.

Wie durchsucht man Hacker News mit der Algolia API?

Die Suche läuft auf einem eigenen Host mit zwei Pfaden: /api/v1/search sortiert nach Relevanz, dann nach Punkten, dann nach Kommentarzahl, und /api/v1/search_by_date sortiert die neuesten zuerst. Beide akzeptieren query für Volltext, tags für Typfilter, numericFilters für Bedingungen auf created_at_i, points und num_comments, dazu page und hitsPerPage für die Seitennavigation. Filtern Sie mit tags, bevor Sie in Ihrem eigenen Code filtern, denn die gültigen Werte umfassen story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_:USERNAME und story_:ID.

curl "https://hn.algolia.com/api/v1/search?query=postgres&tags=story&hitsPerPage=1"
curl "https://hn.algolia.com/api/v1/search_by_date?tags=story&numericFilters=created_at_i>1788998400"
curl "https://hn.algolia.com/api/v1/search?tags=comment,story_18717168"
curl "https://hn.algolia.com/api/v1/search?tags=front_page"

{
  "hits": [
    {
      "objectID": "18717168",
      "title": "Bye Bye Mongo, Hello Postgres",
      "url": "https://www.theguardian.com/info/2018/nov/30/bye-bye-mongo-hello-postgres",
      "author": "philliphaydon",
      "points": 1562,
      "num_comments": 417,
      "created_at": "2018-12-19T17:08:53Z",
      "created_at_i": 1545239333,
      "story_id": 18717168,
      "_tags": ["story", "author_philliphaydon", "story_18717168"]
    }
  ],
  "nbHits": 14776,
  "page": 0,
  "nbPages": 1000,
  "hitsPerPage": 1,
  "processingTimeMS": 13
}

Tags werden standardmäßig mit UND verknüpft und innerhalb von Klammern mit ODER, sodass author_pg,(story,poll) als Autor pg UND (story ODER poll) zu lesen ist. Das ist die gesamte Abfragesprache, und sie ist enger als die booleschen Suchoperatoren, die Sie für eine Suchmaschine schreiben würden, sodass die Stichwortabdeckung aus mehreren Abfragen kommen muss statt aus einer cleveren. hitsPerPage steht standardmäßig auf 20.

Wie hoch sind die Rate Limits der Hacker News API?

Die beiden APIs veröffentlichen unterschiedliche Antworten. Die README von HackerNews/API sagt "There is currently no rate limit" für die Firebase-Endpunkte, und die Dokumentation unter hn.algolia.com/api sagt, dass Algolia eine einzelne IP auf 10.000 Anfragen pro Stunde begrenzt und Adressen sperrt, die das überschreiten. Für die Firebase-Seite deckt keine veröffentlichte Zahl den Spielraum ab, behandeln Sie diesen Puffer also als Entgegenkommen und nicht als Zusage, und halten Sie Ihr Polling in beiden Fällen ehrlich.

Kalkulieren Sie die Algolia-Seite, bevor Sie die Schleife schreiben:

Anfragen pro Stunde = (3600 / Poll-Intervall in Sekunden) x Anzahl gespeicherter Abfragen

Dreißig gespeicherte Abfragen bei einem Intervall von 60 Sekunden ergeben 3600 / 60 = 60 Abrufe pro Abfrage und Stunde, und 60 x 30 = 1.800 Anfragen pro Stunde, also 18 Prozent des Kontingents von 10.000. Kommt auf der Firebase-Seite eine Aktualisierung der Startseite dazu, kostet das 1 Anfrage für /v0/topstories.json plus 500 Item-Anfragen, also 501 Anfragen pro Durchlauf. Wer schon einmal um Reddits API-Rate-Limits herum kalkuliert hat, wird beide Zahlen im Vergleich großzügig finden.

Was kann die Hacker News API nicht?

Beide APIs sind nur lesend, also postet kein Endpunkt eine story, stimmt ab oder antwortet auf einen comment, und kein Pfad akzeptiert Zugangsdaten, die das erlauben würden. Algolia deckelt außerdem die Seitennavigation: nbPages multipliziert mit hitsPerPage kam bei jeder am 10. September 2026 getesteten Seitengröße auf exakt 1.000 zurück, und die Anfrage nach Seite 60 bei 20 Treffern pro Seite lieferte ein leeres hits-Array, was heißt, dass eine Abfrage 1.000 Ergebnisse erreicht und nicht mehr. Zerlegen Sie eine breite Suche mit numericFilters auf created_at_i in Zeiträume, wenn Sie alles hinter dieser Mauer brauchen.

Keine der beiden APIs benachrichtigt Sie. Es gibt keinen Webhook, keine E-Mail, keine Stichwortüberwachung, keine Deduplizierung über wiederholte Erwähnungen hinweg und kein Urteil darüber, welcher Thread eine Antwort wert ist. Genau diese Lücke füllt RedReplier: Es nimmt eine Website und eine Reihe von Stichwörtern, beobachtet Hacker News neben Reddit, X, Bluesky und Facebook an einem Ort, bewertet jede Erwähnung nach Kaufabsicht, erklärt per KI, warum sie markiert wurde, und schickt Ihnen je nach Tarif in einem festen Intervall eine E-Mail. Dasselbe Produkt bietet außerdem API-Zugriff und einen MCP-Server, der mit Claude Code, Cursor und jedem standardkonformen MCP-Client funktioniert, was den Unterschied ausmacht zwischen roher Datenerhebung in sozialen Medien und einer Warteschlange von Gesprächen, die eine Antwort verdienen.

Häufig gestellte Fragen

Braucht die Hacker News API einen API-Schlüssel?

Nein. Weder hacker-news.firebaseio.com/v0/ noch hn.algolia.com/api/v1/ vergibt Schlüssel, und keiner von beiden akzeptiert ein Token. Ein einfaches, nicht authentifiziertes GET liefert von beiden Hosts JSON zurück, weshalb ein einzelner curl-Befehl reicht, um jeden Endpunkt auf dieser Seite zu testen.

Gibt es ein offizielles Rate Limit der Hacker News API?

Algolia veröffentlicht eines, Firebase nicht. Die Dokumentation unter hn.algolia.com/api deckelt eine einzelne IP bei 10.000 Anfragen pro Stunde, und die README von HackerNews/API sagt "There is currently no rate limit" für die Firebase-Endpunkte. Für Firebase existiert keine dokumentierte Zahl, wer also eine konkrete Anfragen-pro-Sekunde-Zahl dafür nennt, rät.

Wie bekomme ich alle Kommentare zu einer Hacker-News-Story?

Zwei Wege funktionieren. Auf Firebase lesen Sie das kids-Array der story und steigen rekursiv in jedes Kind-Item ab, was eine Anfrage pro Kommentar kostet. Auf Algolia liefert eine Anfrage an /api/v1/search?tags=comment,story_<ID> die Kommentare als Suchtreffer, begrenzt durch den Seitendeckel von 1.000 Ergebnissen.

Was ist der Unterschied zwischen der Firebase API und der Algolia API?

Firebase ist der Live-Datenbestand und Algolia der Index darüber. Firebase beantwortet "gib mir Item 8863" und "was steht gerade auf der Startseite" mit Feldern wie score, kids und descendants. Algolia beantwortet "welche stories erwähnen postgres" mit Feldern wie points, num_comments und created_at_i, und es ist das einzige der beiden, das Volltextsuche kann.

Kann ich über die API auf Hacker News posten oder abstimmen?

Nein. Beide APIs sind nur lesend, und keine dokumentiert einen Schreibpfad zum Einreichen von Stories, Posten von Kommentaren oder Abstimmen. Was auch immer in Ihrem Namen auf Hacker News postet, steuert die Website, nicht die API.

Wie weit reichen die Daten der Hacker News API zurück?

Bis zum ersten Item auf der Seite. Item-ID 1 ist eine story mit dem Titel "Y Combinator", gepostet vom Nutzer pg, mit einem Unix-time von 1160418111, was sie in den Oktober 2006 legt. Von dort laufen die IDs fortlaufend bis zu dem Wert, den /v0/maxitem.json heute meldet.

Wie bekomme ich die aktuelle Hacker-News-Startseite über die API?

Der Firebase-Endpunkt /v0/topstories.json liefert bis zu 500 sortierte IDs für die Startseite, und jede ID braucht danach eine eigene Anfrage an /v0/item/<id>.json, um Titel, Score und URL aufzulösen. Algolia bietet eine Abkürzung für dieselbe Liste: /api/v1/search?tags=front_page liefert die Startseite als Suchtreffer in einer einzigen Anfrage. Firebase eignet sich, wenn man die Live-Rangliste mit allen Feldern braucht, Algolia, wenn eine Anfrage reicht.

Kann ich Hacker-News-Suchergebnisse nach Punktzahl oder Kommentaranzahl filtern?

Die Algolia API akzeptiert numericFilters für Bedingungen auf points und num_comments, zusätzlich zu created_at_i für Zeiträume. Eine Anfrage wie numericFilters=points>500 schränkt /api/v1/search auf Storys über diesem Score ein, mehrere Filter lassen sich mit einem Komma kombinieren. Firebase führt dieselben Felder score und descendants bei jedem Item, kennt aber keinen Filterparameter, sodass man dort Items abrufen und die Felder selbst prüfen muss.

Wie verfolge ich neue Hacker-News-Beiträge direkt nach der Veröffentlichung?

/v0/newstories.json bei Firebase liefert die neuesten Item-IDs, bis zu 500 auf einmal, und ein Vergleich mit der vorherigen Abfrage zeigt die neu hinzugekommenen IDs. Zusammen mit /v0/maxitem.json, das die aktuelle Obergrenze des gesamten Bestands liefert, zeigt ein Sprung dieser Zahl neue Items an, noch bevor man sie einzeln auflistet. Die Aussage "There is currently no rate limit" im README bedeutet, dass häufiges Abfragen dieses Endpunkts dokumentiert nichts kostet, aber die Algolia-Budgetrechnung aus diesem Artikel gilt weiterhin, sobald Suchanfragen dazukommen.

Kann ich alle Beiträge eines bestimmten Hacker-News-Nutzers abrufen?

/v0/user/<id>.json bei Firebase liefert ein Profil mit dem Feld submitted, einem Array aller Item-IDs, die dieser Nutzer gepostet hat, Kommentare eingeschlossen. Jede ID lässt sich mit /v0/item/<id>.json auflösen, um Titel, Text und Score zu erhalten, nach demselben Muster einer Anfrage pro ID wie beim Durchlaufen eines Kommentarbaums. Der Algolia-Tag author_:USERNAME filtert Suchtreffer ebenfalls nach Autor, was schneller geht, wenn nur Storys gebraucht werden und nicht der vollständige Beitragsverlauf.