常见问题

真的免费吗？

免费计划确实免费。获取密钥并运行此命令：

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

免费计划每月允许 3,000 次请求，每分钟允许 120 次请求。从 1 年 2026 月 1 日起需要密钥。

有什么限制？

直白地说，有三点。窗口期是 90 天，而非数年。没有服务等级协议（SLA）。也没有情感分析或实体抽取——竞争对手对这些功能收费，而我们尚未提供。我们缺失功能的完整列表。

我可以用于商业用途吗？

是的，无需升级且无需额外许可。请注意，NewsAPI.org 和 GNews 在其免费层级中禁止商业用途，无论使用量多少——请仔细查看其他平台的使用条款。

向用户展示内容时，请链接回原始文章 url。这是出版商的工作。

数据从哪里来？

大规模公共新闻档案：持续发布的已抓取新闻页面批量集合。我们对每次发布进行处理并建立索引。了解更多来源信息。

数据有多新？如何验证？

语料库全天持续更新。每个摄入批次都会发布在 快照 中，包含文件名、文章数量和时间戳，而 状态 和 /health 则暴露实时服务状态。因此，您可以自行衡量数据的新鲜度，而不是依赖声称“实时”的市场营销标签。

为什么只保留 90 天的数据？

这是在不使其成为成本中心的前提下，我们能提供的最大空间。这种权衡换来了免费套餐。如果需要历史数据，请购买归档服务——NewsData.io 和 Perigon 都提供多年的归档数据。

我能获取完整的文章正文吗？

是的，使用 full_text=true 即可免费获取。所有竞争对手都将文章正文（article bodies）放在付费层级之后。正文内容通常较大——在请求上百条之前，请先检查 token 成本。

覆盖哪些新闻源？

当前索引包含来自 25,000 多家新闻发布商的内容，通常每天有数千家处于活跃状态。覆盖范围基于公共档案和我们的订阅源阅读器所捕获的内容；范围广泛，但不保证涵盖任何特定出版商。请使用 发布商目录 和 来源细分 在构建应用前检查主机名。

为什么国家字段有时会出错？

由于该信息是推断得出的，我们会告知您推断方式。country_source 字段会说明来源是国家级域名（可靠）、发布商自身的标记（可靠）、区域设置标签（通常正确）还是 en-US 模板默认值（不可靠）。如需进行国家层面的分析，请添加 strict_country=true。 完整说明。

我可以按相关性而非日期获取结果吗？

是的：sort=relevance。默认值为 date，因为大多数调用者希望获取最新内容。轮询时使用 sort=crawled——出版商可能会回溯发布日期，但抓取时间不会倒退。

如何获取一整天的数据？

按时间切片。偏移量上限为 9,900，每天约有 110,000 篇文章。循环逻辑位于 分页 中。

有 MCP 服务器吗？

是的。服务器位于 /mcp，使用 Streamable HTTP 协议并需要您的 API 密钥。它提供了精心策划的新闻搜索、趋势、出版商和市场工具，以及基于 OpenAPI 模式生成的工具。/mcp.json 返回机器可读的工具目录，MCP 指南 展示了客户端配置方法。

你们有 SDK 吗？

不需要，您也无需 API 密钥。它提供四个返回 JSON 数据的 GET 端点。任何语言中的任何 HTTP 客户端均可作为 SDK。示例见 快速入门。

如果我的需求超过免费计划怎么办？

查看 套餐，或 咨询。如果您正在进行批量导出，有一种比 100,000 次 HTTP 请求更好的方式。

你们会追踪我吗？

我们仅保留运行服务所需的数据：你的账户信息、各 API Key 的使用情况以及服务器日志。没有广告网络，没有数据经纪商。完整的隐私说明。

我是新闻发布者，希望移除我的网站。

联系我们，我们直接处理，无需争辩。详情。