Hacker News API

開発とデータ · Hacker News API の結果 · 公開ソース

公式ドキュメント

現在の公開データ

Hacker News API から新しい結果を読み込みます。検索語の入力は不要です。

レスポンスに含まれる項目

確認したい項目

開発とデータ
Hacker News API の結果
公開ソース

topstories の一覧には ID だけが入る

/v0/topstories.json は Hacker News の表示順に数値識別子の列を返します。ドキュメントでは最大 500 件の主要記事を含み、求人も含まれることがあると説明されています。対応する item を問い合わせるまで、ID にはタイトル、リンク、投稿者、スコア、コメントは入りません。

記事を開くには各番号を /v0/item/{id}.json で使います。
応答内の位置を恒久的な順位として扱わないでください。
求人を出したくない画面では type を絞り込みます。

item が表示内容を説明する

記事には id、type、by、time、title、url、score、descendants、kids が入ることがあります。type は story、job、comment、poll、pollopt を区別します。time は Unix time、title と text には HTML を含むことがあり、descendants は記事または投票のコメント総数、kids は直接のコメントを表示順で並べます。

読みやすい日付を出す前に time を変換します。
title と text の HTML は表示前にサニタイズしてください。
url がある場合は外部の行き先に使います。すべての記事にあるわけではありません。