TL;DR
8 min czytaniaHacker 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.

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.
| Endpoint | Co zwraca | Rozmiar |
|---|---|---|
/v0/item/<id>.json | jedno zgłoszenie, komentarz, ofertę pracy, ankietę lub opcję ankiety | jeden obiekt |
/v0/user/<id>.json | jeden profil: id, created, karma, about, submitted | jeden obiekt |
/v0/maxitem.json | aktualnie największe id elementu | jedna liczba całkowita |
/v0/topstories.json | id ze strony głównej według rankingu, łącznie z ofertami pracy | do 500 id |
/v0/newstories.json | id najnowszych elementów | do 500 id |
/v0/beststories.json | id zgłoszeń z najwyższą punktacją | lista id |
/v0/askstories.json | id wpisów Ask HN | do 200 id |
/v0/showstories.json | id wpisów Show HN | do 200 id |
/v0/jobstories.json | id ofert pracy | do 200 id |
/v0/updates.json | zmienione elementy i profile | tablice 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.

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.
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
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
Ż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


Statystyki Hacker News prosto z jego własnego API na żywo
Każda liczba w tym artykule pochodzi bezpośrednio z zapytań o statystyki Hacker News do publicznego API na żywo, a nie z przestarzałych szacunków.


Publikacja Show HN: co według Hacker News naprawdę się kwalifikuje
Show HN jest dla czegoś, co zrobisz sam i co inni mogą wypróbować. Co Hacker News dopuszcza, jaka jest zasada tytułu i czym to się różni od Ask HN.


Co daje blokada na Bluesky, kto ją widzi i czym różni się od wyciszenia
Co daje blokada na Bluesky: zatrzymuje odpowiedzi, cytaty i wzmianki w obie strony, jest publicznym rekordem w AT Protocol i różni się od wyciszenia.

