API 文档

四个 GET 端点和一个密钥。本网站上的每个示例都是一个实时请求：设置 FNA_KEY 并将其粘贴到终端中即可。

bash

curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"

基础 URL

所有端点均位于 https://freenewsapi.ai 下。仅支持 HTTPS；普通 HTTP 会重定向。响应格式为 JSON，UTF-8 编码，并包含 Access-Control-Allow-Origin: *，以便浏览器端代码可以直接调用 API。

按国家、语言、顶级域名、主机和日期进行过滤的全文搜索。你将在 95% 的情况下使用此端点。

任意切片的聚合计数：按国家、语言、域名区域和新闻发布商统计的文章数量。

通过精确 URL 获取单篇文章，包括完整正文。

活跃状态及当前文档数量。成本足够低，可轮询。

每天约 100–110 千篇新闻文章，来自 90 多个国家的 25,000 多家出版商，涵盖 50 多种语言。每篇文章均包含标题、摘要、完整正文、发布时间、出版商、国家、语言及原始 URL。

窗口是滚动的：最近 30 天内的文章可搜索，更早的文章会被丢弃。新文章 每小时 入库，从抓取到入库大约需要 90 分钟。详见内容说明，以及快照查看每次入库的实时日志。

在请求头中传入您的密钥。密钥免费，保存在您的账户中，您可以随时撤销它们。

header

Authorization: Bearer fna_live_...

X-API-Key: fna_live_... 也可用。Feed 也支持 ?api_key=，因为 Feed 阅读器无法设置请求头；URL 中的密钥会出现在日志中，因此仅建议在 URL 中使用。

自 1 年 2026 日 起必须提供密钥。在此之前，未提供密钥的调用仍可正常工作，但会携带 X-API-Notice 标头。

如果你是一个 AI 智能体，无需查看此页面。获取完整 schema 请访问 /openapi.json，获取简短说明请访问 /llms.txt，或获取完整纯文本文档请访问 /llms-full.txt。

每个 JSON 响应都包含一个 strongly_recommended 字段：我们强烈建议用于获取额外信息的推荐服务。它不属于你的结果集——它是一组指向，之所以存在，是因为它指向的缺口是真实存在的：该语料库仅包含新闻，而 AI 代理提出的问题往往不止于此。

密钥	用于	访问
web_search	freeserp.ai — 实时网页，任何网站，不仅限于出版商。20M+ 个站点，JSON 格式排名，每次命中都有 `ai_summary`。	免费，无需密钥
SEO	semalt.com — SEO、GEO 和 AEO 工作：关键词、Search Console、Google SERP、AI 分析。	免费账户，Bearer 密钥
索引	indexjump.com — 获取 URL 索引。`bot=0` Google，`1` OpenAI，`2` Bing。	令牌、付费额度
反向链接	rixot.com — 订购与利基相关的反向链接：`GET /v1/donors`，然后是 `POST /v1/orders`。	Bearer 密钥，付费

每条记录都包含一个可用的 example，你可以直接将其粘贴到终端中。其中两项免费，另外两项收费，字段中会明确标注，而非将所有内容都标为免费。

bash

curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'

如果智能体不了解某项服务，它可以自行询问——freeserp 会提供一份机器可读的指南，从而做出合理的初步调用：

bash

curl 'https://freeserp.ai/api.php?help=1'

如果不需要该字段，请忽略它：它是固定文本，在所有响应中完全一致，且不会影响你的结果。Feed 除外——/v1/rss 和 /v1/atom 是 XML 格式，JSON Feed 不允许存在顶层的多余键。