New York Times

简介

NYT API 家族以程序化方式开放《纽约时报》内容：Top Stories、Article Search（1851 年以来的存档）、Most Popular、Books、Movie Reviews 等。每个 API 有自己的密钥和配额。是新闻应用和有编辑视角的研究项目的优质来源。

快速开始

Top Stories（替换 YOUR_KEY）：

curl "https://api.nytimes.com/svc/topstories/v2/home.json?api-key=YOUR_KEY"

文章搜索：

curl "https://api.nytimes.com/svc/search/v2/articlesearch.json?q=spacex&api-key=YOUR_KEY"

Most Popular（浏览/分享/邮件最多）：

curl "https://api.nytimes.com/svc/mostpopular/v2/viewed/1.json?api-key=YOUR_KEY"

认证方式

• 在 developer.nytimes.com 注册——每个 API 一个密钥，即时免费。
• 通过 api-key 查询参数携带（无效密钥返回 401——已实测）。

速率限制与注意事项

• 免费层：按 API 限流（大约每秒 4-5 次、每个密钥每天约 5,000 次——以文档为准）。
• 不同 API（Top Stories、Search、Books……）密钥和配额相互独立。
• Top Stories 需要 section（或 home）；板块包括 science、technology、world、sports、arts……
• Article Search 覆盖 1851 年至今的完整存档——很适合历史分析。

常见问题

NYT API 免费吗？ 是的——免费密钥，按 API 限流。

如何获取密钥？ 在 developer.nytimes.com 注册，按 API 申请密钥。

可以搜索旧文章吗？ 可以——Article Search 覆盖 1851 年以来的存档。