Hacker News API

概览

GitHubGitHub

Hacker News API 是由 Hacker News 与 Firebase 合作提供的官方公开数据接口，允许开发者以近实时的方式获取 Hacker News 上的内容。该 API 支持 Android、iOS、Web 以及服务端等多种平台接入。 ## 基本信息 - **基础 URI**：`https://hacker-news.firebaseio.com/v0/` - **版本控制**：当前为 v0 版本。仅当移除非可选字段或修改现有字段时视为不兼容变更，客户端应忽略未知的新增字段。 - **速率限制**：目前没有速率限制。 - **开源协议**：MIT ## 数据模型 API 的设计本质上是 Hacker News 内存数据结构的直接导出。Stories、comments、jobs、Ask HNs 和 polls 统一被称为 items，通过唯一整数 ID 标识，访问路径为 `/v0/item/<id>.json`。 每个 item 可能包含以下字段： - **id**（必填）：唯一标识符 - **type**：类型，包括 `job`、`story`、`comment`、`poll`、`pollopt` - **by**：作者用户名 - **time**：创建时间（Unix Time） - **text**：内容文本（HTML 格式） - **parent**：父级 item ID（用于评论） - **kids**：子评论 ID 列表（按排序展示） - **url**：故事链接 - **score**：分数或投票数 - **title**：标题（HTML 格式） - **descendants**：总评论数（适用于 story 或 poll） - **parts**：关联的 pollopt 列表 - **deleted** / **dead**：删除或失效状态标记 ## 设计说明 官方文档指出，该 API 并非理想的公共 API 设计。例如，要获取文章的总评论数需要遍历树结构并计数；要获取最新评论需要从 maxid 开始倒序遍历。尽管如此，使用该 API 可以实现 Hacker News 的大部分功能。 ## 适用场景 适合需要读取 Hacker News 公开数据来构建第三方客户端、数据分析工具或聚合应用的开发者。建议优先使用 Firebase 客户端库以获得更好的网络处理效率和事件监听能力。

Q&A

API 有速率限制吗？由 AI 生成

根据文档说明，目前该 API 没有速率限制。

如何获取某个帖子或评论的数据？由 AI 生成

所有类型的内容都是 item，通过 GET 请求 `/v0/item/<id>.json` 即可获取对应数据。

API 的版本策略是什么？由 AI 生成

当前为 v0 版本，URI 前缀为 `https://hacker-news.firebaseio.com/v0/`。只有移除非可选字段或修改现有字段才被视为不兼容变更，客户端应忽略未预期的新增字段。

为什么获取评论总数比较麻烦？由 AI 生成

官方说明该 API 本质上是 HN 内存数据结构的直接导出，并未针对网络请求做优化。获取评论总数需要遍历 kids 树结构并自行计数。