The Guardian

简介

Guardian Open Platform 通过免费 API 开放卫报的完整文章档案——数百万篇文章，含栏目、标签、作者和正文。它是新闻应用和研究项目最好的免费优质新闻来源之一。

小贴士：开发和测试可以用 API key test（实测可用——返回真实文章）。

快速开始

搜索文章——test key 即可（实测可用）：

curl "https://content.guardianapis.com/search?q=technology&page-size=5&api-key=test"

某栏目的最新文章：

curl "https://content.guardianapis.com/world?api-key=test"

完整文章内容：

curl "https://content.guardianapis.com/politics/2026/jul/18/example-slug?show-fields=body&api-key=test"

标签与栏目列表：

curl "https://content.guardianapis.com/tags?q=technology&api-key=test"
curl "https://content.guardianapis.com/sections?api-key=test"

认证方式

• 在 open-platform.theguardian.com 免费注册获取 API key（即时生效，邮件发送）。
• 通过 api-key 传递（查询参数或 X-Guardian-API-Key 请求头）。
• 开发环境用 test。

速率限制与注意事项

• 免费层有速率限制（大约 12 次/秒突发，另有每日/每月上限——以官网为准）。
• 内容为非商业许可——商业化再分发前请查看 Open Platform 条款。
• show-fields=body 返回完整正文；不带它只返回元数据（响应更小）。
• 通过 page / page-size 分页。

常见问题

Guardian API 免费吗？ 是的——免费密钥带速率限制；内容仅限非商业使用。

生产环境可以用 test key 吗？ 不行——它仅供开发。请注册正式密钥。

能获取完整文章吗？ 可以——show-fields=body 返回完整正文。