glossary

JSON na żywo i bez klucza: jak korzystać z API Hacker News

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
JSON na żywo i bez klucza: jak korzystać z API Hacker NewsJSON na żywo i bez klucza: jak korzystać z API Hacker News

TL;DR

8 min czytania

Hacker News udostępnia dwa darmowe publiczne API i żadne z nich nie wydaje kluczy. API Firebase pod adresem hacker-news.firebaseio.com/v0/ serwuje pojedyncze elementy, profile użytkowników i rankingowe listy zgłoszeń, a jego README stwierdza, że obecnie nie ma limitu zapytań. API Algolia pod adresem hn.algolia.com/api/v1/ obsługuje wyszukiwanie pełnotekstowe i ogranicza pojedynczy adres IP do 10 000 żądań na godzinę.

Jak korzystać z API Hacker News?

Każde pytanie o to, jak korzystać z API Hacker News, sprowadza się do jednego z dwóch darmowych hostów: hacker-news.firebaseio.com/v0/ serwuje elementy na żywo, profile użytkowników i rankingowe listy zgłoszeń, a hn.algolia.com/api/v1/ obsługuje wyszukiwanie pełnotekstowe. Oba zwracają zwykły JSON przez HTTPS, oba przyjmują anonimowe żądania i żaden nie wydaje kluczy API ani nie przyjmuje tokena. Sięgnij po Firebase, gdy znasz już id elementu albo chcesz pobrać aktualną stronę główną, a po Algolię, gdy masz słowo kluczowe, ale nie masz id.

Co API Firebase zwraca dla jednego elementu?

API Firebase zwraca jeden płaski obiekt JSON na element z /v0/item/<id>.json, a id to jedyne pole obecne w każdym elemencie. README repozytorium HackerNews/API wymienia jako pola opcjonalne deleted, type, by, time, text, dead, parent, poll, kids, url, score, title, parts i descendants, przy czym type przyjmuje jedną z wartości "job", "story", "comment", "poll" lub "pollopt". Pisz parser tak, by opierał się na id i obsługiwał to, co znajdzie poza nim, bo komentarz ma parent i text tam, gdzie zgłoszenie ma url, score i descendants.

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"
}

To odpowiedź na żywo dla elementu 8863 z tablicą kids skróconą do czterech id; prawdziwa zawiera ich 33. time to uniksowy znacznik czasu w sekundach, descendants liczy całe drzewo komentarzy, a kids zawiera tylko bezpośrednie odpowiedzi, więc przejście przez cały wątek oznacza rekurencyjne schodzenie po kids, po jednym żądaniu naraz.

Programista wpisuje polecenia w terminalu na laptopie, obok listy endpointów API Hacker News.

Jakie endpointy ma API Hacker News?

API Firebase udostępnia dziesięć ścieżek, wszystkie typu GET i wszystkie zakończone na .json. Każda ścieżka listy zwraca tablicę id elementów, a nie same elementy, więc odczyt listy to jedno żądanie plus po jednym żądaniu na każde id, które potem rozwiniesz.

EndpointCo zwracaRozmiar
/v0/item/<id>.jsonjedno zgłoszenie, komentarz, ofertę pracy, ankietę lub opcję ankietyjeden obiekt
/v0/user/<id>.jsonjeden profil: id, created, karma, about, submittedjeden obiekt
/v0/maxitem.jsonaktualnie największe id elementujedna liczba całkowita
/v0/topstories.jsonid ze strony głównej według rankingu, łącznie z ofertami pracydo 500 id
/v0/newstories.jsonid najnowszych elementówdo 500 id
/v0/beststories.jsonid zgłoszeń z najwyższą punktacjąlista id
/v0/askstories.jsonid wpisów Ask HNdo 200 id
/v0/showstories.jsonid wpisów Show HNdo 200 id
/v0/jobstories.jsonid ofert pracydo 200 id
/v0/updates.jsonzmienione elementy i profiletablice items i profiles

Udokumentowane rozmiary to górne granice, a nie stałe długości. Przy zapytaniu z 10 września 2026 roku /v0/topstories.json zwrócił pełne 500 id, /v0/askstories.json tylko 28, a /v0/maxitem.json wartość 49 649 544. Id są kolejne, począwszy od elementu 1, czyli zgłoszenia zatytułowanego "Y Combinator", opublikowanego przez użytkownika pg z wartością time równą 1160418111, więc crawler może przejść cały zbiór, po prostu licząc w górę. Dzięki tym kolejnym id statystyki Hacker News, które można pobrać z tych samych endpointów, da się sprawdzić samodzielnie, zamiast polegać na informacjach z drugiej ręki.

Lupa nad wydrukowanymi stronami na biurku, obok sekcji o przeszukiwaniu Hacker News za pomocą Algolii.

Jak przeszukiwać Hacker News przez API Algolia?

Wyszukiwanie działa na osobnym hoście z dwiema ścieżkami: /api/v1/search sortuje według trafności, potem punktów, a potem liczby komentarzy, natomiast /api/v1/search_by_date pokazuje najpierw najnowsze wyniki. Obie przyjmują query dla wyszukiwania pełnotekstowego, tags dla filtrów typu, numericFilters dla warunków na created_at_i, points i num_comments oraz page i hitsPerPage do stronicowania. Filtruj przez tags, zanim zaczniesz filtrować we własnym kodzie, bo prawidłowe wartości obejmują story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_:USERNAME i 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
}

Tagi są domyślnie łączone przez AND, a w nawiasach przez OR, więc author_pg,(story,poll) czyta się jako autor pg AND (story OR poll). To cały język zapytań, węższy niż operatory wyszukiwania logicznego, których można użyć w wyszukiwarce, dlatego pokrycie słów kluczowych trzeba osiągać kilkoma zapytaniami zamiast jednego sprytnego. hitsPerPage ma domyślnie wartość 20.

Jakie limity zapytań ma API Hacker News?

Oba API odpowiadają na to inaczej. README repozytorium HackerNews/API stwierdza "There is currently no rate limit" dla endpointów Firebase, a dokumentacja hn.algolia.com/api podaje, że Algolia ogranicza pojedynczy adres IP do 10 000 żądań na godzinę i blokuje adresy, które ten limit przekroczą. Po stronie Firebase nie ma żadnej opublikowanej liczby, więc traktuj ten zapas jako uprzejmość, a nie gwarancję, i w obu przypadkach odpytuj z umiarem.

Zanim napiszesz pętlę, policz budżet po stronie Algolii:

żądania na godzinę = (3600 / interwał odpytywania w sekundach) x liczba zapisanych zapytań

Trzydzieści zapisanych zapytań przy interwale 60 sekund daje 3600 / 60 = 60 odpytań na zapytanie na godzinę oraz 60 x 30 = 1 800 żądań na godzinę, czyli 18 procent limitu 10 000. Dodaj odświeżanie strony głównej po stronie Firebase, a koszt to 1 żądanie do /v0/topstories.json plus 500 żądań o elementy, czyli 501 żądań na przebieg. Każdy, kto planował budżet pod limity API Reddita, uzna obie te liczby za hojne.

Budżet godzinowego limitu Algolii
Godzinowy limit Algolii10 000 żądań
30 zapytań odpytywanych co 60 sekund1 800 żądań
Pozostały zapas8 200 żądań
Trzydzieści zapisanych zapytań odpytywanych co 60 sekund zużywa 18 procent godzinowego limitu Algolii wynoszącego 10 000 żądań. To przykład omówiony w tym artykule.

Czego API Hacker News nie potrafi?

Oba API służą tylko do odczytu, więc żaden endpoint nie opublikuje zgłoszenia, nie odda głosu ani nie odpowie na komentarz, a żadna ścieżka nie przyjmuje danych logowania, które by na to pozwoliły. Algolia ogranicza też stronicowanie: iloczyn nbPages i hitsPerPage wynosił dokładnie 1 000 przy każdym rozmiarze strony sprawdzonym 10 września 2026 roku, a żądanie strony 60 przy 20 wynikach na stronę zwróciło pustą tablicę hits, co oznacza, że jedno zapytanie sięga 1 000 wyników i ani jednego dalej. Gdy potrzebujesz wszystkiego, co leży za tą granicą, podziel szerokie wyszukiwanie na zakresy dat za pomocą numericFilters na created_at_i.

Żadne z tych API nie wysyła powiadomień. Nie ma webhooków, e-maili, obserwowania słów kluczowych, deduplikacji powtarzających się wzmianek ani oceny, który wątek wart jest odpowiedzi. Tę lukę wypełnia RedReplier: bierze adres witryny i zestaw słów kluczowych, obserwuje Hacker News razem z Redditem, X, Bluesky i Facebookiem w jednym miejscu, układa wzmianki według intencji zakupowej, wyjaśnia z pomocą AI, dlaczego dana wzmianka została oznaczona, i wysyła e-maile w odstępach zależnych od planu. Ten sam produkt udostępnia też dostęp przez API i serwer MCP współpracujący z Claude Code, Cursorem i każdym standardowym klientem MCP. To różnica między surowym zbieraniem danych z mediów społecznościowych a kolejką rozmów wartych odpowiedzi.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Najczęściej zadawane pytania

Czy API Hacker News wymaga klucza API?

Nie. Ani hacker-news.firebaseio.com/v0/, ani hn.algolia.com/api/v1/ nie wydają kluczy i żaden z nich nie przyjmuje tokena. Zwykłe nieuwierzytelnione żądanie GET zwraca JSON z obu hostów, dlatego do przetestowania każdego endpointu z tej strony wystarczy jedno polecenie curl.

Czy API Hacker News ma oficjalny limit zapytań?

Algolia publikuje limit, a Firebase nie. Dokumentacja hn.algolia.com/api ogranicza pojedynczy adres IP do 10 000 żądań na godzinę, a README repozytorium HackerNews/API mówi "There is currently no rate limit" w odniesieniu do endpointów Firebase. Dla Firebase nie istnieje żadna udokumentowana liczba, więc każdy, kto podaje konkretną wartość żądań na sekundę, zgaduje.

Jak pobrać wszystkie komentarze do zgłoszenia na Hacker News?

Działają dwa sposoby. W Firebase odczytaj tablicę kids zgłoszenia i rekurencyjnie schodź do każdego elementu podrzędnego, co kosztuje jedno żądanie na komentarz. W Algolii jedno żądanie do /api/v1/search?tags=comment,story_<ID> zwraca komentarze jako wyniki wyszukiwania, z zastrzeżeniem limitu stronicowania wynoszącego 1 000 wyników.

Czym różni się API Firebase od API Algolia?

Firebase to zapis na żywo, a Algolia to zbudowany na nim indeks. Firebase odpowiada na „daj mi element 8863” i „co jest teraz na stronie głównej”, używając pól takich jak score, kids i descendants. Algolia odpowiada na „które zgłoszenia wspominają o postgres”, używając pól takich jak points, num_comments i created_at_i, i tylko ona z tej dwójki oferuje wyszukiwanie pełnotekstowe.

Czy mogę publikować lub głosować na Hacker News przez API?

Nie. Oba API służą tylko do odczytu i żadne nie dokumentuje ścieżki zapisu do wysyłania zgłoszeń, publikowania komentarzy czy głosowania. Wszystko, co publikuje na Hacker News w twoim imieniu, steruje stroną internetową, a nie API.

Jak daleko wstecz sięgają dane API Hacker News?

Do pierwszego elementu w serwisie. Element o id 1 to zgłoszenie zatytułowane "Y Combinator", opublikowane przez użytkownika pg, z uniksową wartością time równą 1160418111, co przypada na październik 2006 roku. Od tego miejsca id biegną kolejno aż do wartości, którą /v0/maxitem.json podaje dziś.

Jak pobrać aktualną stronę główną Hacker News przez API?

Endpoint /v0/topstories.json w API Firebase zwraca uszeregowane id ze strony głównej, maksymalnie 500, a każde z nich wymaga osobnego żądania do /v0/item/<id>.json, by uzyskać tytuł, punktację i adres URL. Algolia oferuje skrót do tej samej listy: /api/v1/search?tags=front_page zwraca stronę główną jako wyniki wyszukiwania w jednym żądaniu. Wybierz Firebase, gdy chcesz mieć ranking na żywo ze wszystkimi polami, a Algolię, gdy wystarczy jedno wywołanie.

Czy mogę filtrować wyniki wyszukiwania Hacker News według punktów lub liczby komentarzy?

API Algolia przyjmuje numericFilters dla warunków na points i num_comments, a także na created_at_i dla zakresów dat. Zapytanie takie jak numericFilters=points>500 zawęża /api/v1/search do zgłoszeń powyżej tej punktacji, a filtry łączy się przecinkiem. Firebase ma te same pola score i descendants przy każdym elemencie, ale nie oferuje parametru filtrowania, więc filtrowanie oznacza tam pobranie elementów i samodzielne sprawdzenie pól.

Jak śledzić nowe posty na Hacker News w chwili ich publikacji?

Odpytuj w Firebase /v0/newstories.json, który zwraca id najnowszych elementów, do 500 naraz, i porównuj każdy wynik z id, które już masz. W połączeniu z /v0/maxitem.json otrzymujesz aktualny górny pułap całego zbioru, więc skok tej liczby sygnalizuje nowe elementy, zanim jeszcze je wylistujesz. Zdanie z README "There is currently no rate limit" oznacza, że częste odpytywanie tego endpointu nie ma udokumentowanego kosztu, ale wyliczenia budżetu Algolii z tego artykułu nadal obowiązują, gdy dołączysz wywołania wyszukiwania.

Czy mogę sprawdzić wszystko, co opublikował dany użytkownik Hacker News?

/v0/user/<id>.json w Firebase zwraca profil z polem submitted, czyli tablicą id wszystkich elementów opublikowanych przez tego użytkownika, łącznie z komentarzami. Każde id rozwiń przez /v0/item/<id>.json, by uzyskać tytuły, tekst i punktację. To ten sam schemat jednego żądania na id, którego używa się przy przechodzeniu drzewa komentarzy. Tag author_:USERNAME w Algolii również zawęża wyniki do jednego autora, co jest szybsze, jeśli potrzebujesz tylko zgłoszeń, a nie pełnej historii publikacji.

Więcej naszych treści w Google

Jedno kliknięcie oznacza RedReplier jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

RedReplier

RedReplier

Żaden kupujący pytający o ofertę nie umknie

RedReplier śledzi Reddita, X, Bluesky i Hacker News w czasie rzeczywistym, ocenia każdy wątek pod kątem intencji zakupowej i przygotowuje odpowiedź, by dotrzeć tam jako pierwszy.

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Powiązane artykuły