Free News API：對 2100 萬篇文章、25,000 家出版商和 100 個國家進行全文搜尋——完全無需金鑰

新聞 API 通常按請求次數計費，需要金鑰才能存取，且在免費方案中每日請求次數上限僅為 100 次。Free News API 則完全不同：涵蓋滾動 90 天內的 2150 萬篇文章、25,000 多家出版商，無需金鑰、無需註冊、無使用額度限制，並允許商業用途。以下是其完整功能面——搜尋、統計數據、趨勢、市場、資訊流和 MCP——以及對該數據可能存在的誤差之誠實說明。

問題的本質

當問 AI 代理目前全球正在報導什麼時，它通常有三個糟糕的選擇。它可以直連出版商抓取內容，但這方法脆弱、緩慢且法律界線模糊。它可以呼叫商業新聞 API，但這意味著需要帳戶、金鑰、每月帳單，且在市場上所有免費方案中，每日僅限 100 次請求，且文章會有 24 小時的延遲。或者，它可以根據數個月前就已停止更新的訓練數據進行猜測。

Free News API 移除了中間選項的價格和繁文縟節，卻保留了其能力。只需一個 GET 請求，無需憑證，即可存取一個語料庫，截至撰寫時，該語料庫包含來自 25,000 多家出版商的 21,557,044 篇文章，採用滾動 90 天視窗儲存並持續更新——索引中最新文章的年齡通常不到兩分鐘。

四大核心端點，以及更多

服務的核心是四個 GET 端點，全部位於 https://freenewsapi.ai，均回傳 UTF-8 JSON 並帶有 Access-Control-Allow-Origin: * 標頭，以便瀏覽器程式碼可直接呼叫，同時在 took_ms 欄位回報伺服器端耗時。

圍繞核心還有四個更多產品線，每一條在其他地方都足以成為獨立產品：趨勢（按國家分類的即時故事聚類）、市場（與報導量對齊的價格序列）、加密貨幣情緒（七個端點的比特幣區塊），以及分發（將相同搜尋結果呈現為 RSS、Atom 或 JSON 訂閱源）。以下將涵蓋所有這些內容。

curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"

{
  "took_ms": 41,
  "total": 1284,
  "total_is_lower_bound": false,
  "size": 2,
  "offset": 0,
  "results": [
    {
      "id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
      "url": "https://example-news.com/world/climate-summit-opens",
      "title": "Climate summit opens with a call for binding targets",
      "description": "Delegates from 190 countries gathered on Monday ...",
      "published_at": "2026-08-17T09:12:00Z",
      "crawled_at": "2026-08-17T10:48:31Z",
      "host": "example-news.com",
      "sitename": "Example News",
      "country": "GB",
      "country_source": "cctld",
      "lang": "en",
      "tld": "com"
    }
  ]
}

回應中的三個欄位值得立即關注，因為它們編碼了整個資料集的誠信度。total_is_lower_bound 會告訴您當匹配數量達到 10,000 的上限並停止計數時的情況。country_source 會告訴您國家是如何確定的——因為在任何新聞資料集中，很大比例的國家值是推論而非事實。而 crawled_at 是可信的時間戳記：出版商經常將 published_at 的日期設為過去，但爬取時間是由管線分配的，且只會向前推進。

搜尋：每個重要參數

所有參數都是可選的。空呼叫會回傳索引中最新的文章。

查詢

• q 與標題（權重 3）、描述（權重 2）及文章內文進行匹配。AND 語義——每個詞都必須出現，因此增加詞彙會縮小範圍而非擴大。最多 500 個字元。

篩選器

篩選器與跨參數的 AND 以及單一參數內的 OR 結合。因此 country=DE,AT&lang=de 讀作「來自德國或奧地利的德語文章」。每個篩選器接受最多五十個值的逗號分隔列表。

輸出控制

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"

curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

搜尋前的計數

該服務中最常被忽略的端點是 /v1/stats。通常關鍵問題不是「有哪些文章」，而是「這裡到底有沒有內容，以及它們在哪裡」。計數操作的成本僅需約兩百個 token，相較於取得一頁結果所需的數千個 token，這使得它成為代理程式在決定是否執行搜尋時，應優先執行的正確第一步。

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

它會回傳依國家、語言、頂級網域 (TLD)、發布者及日期分類的計數，這些計數是基於整個匹配集合而非當前頁面計算得出。這也是你在信任資料前，用來評估覆蓋範圍的方式。截至撰寫本文時的未篩選快照：

主要國家

主要語言

英語 5,513,650 · 西班牙語 2,699,457 · 俄語 1,785,796 · 土耳其語 1,501,004 · 義大利語 992,200 · 德語 733,677 · 法語 689,136 · 阿拉伯語 664,016 · 葡萄牙語 637,607 · 印地語 560,840 · 希臘語 466,504 · 日語 427,085 · 越南語 385,719 · 羅馬尼亞語 358,766 · 中文 352,720 · 烏克蘭語 345,809 · 韓語 335,079 · 波斯語 268,126 · 波蘭語 238,904 · 保加利亞語 183,204。

這份分佈值得多看幾秒，因為它與大多數新聞 APIs 給你的資料截然相反。通常以英語為先、以美國為先的語料庫並非如此：印度的排名高於美國，土耳其語高於德語，希臘語、越南語、波斯語和保加利亞語也都擁有六位數的數量。如果你的問題是關於非英語媒體，這是一組截然不同的資料集。

數量

by_day 中的每日曲線涵蓋了完整的九十天空間。近期的每日數量約在 每天 400,000 到 700,000 篇文章 之間；而在 RSS 層與歷史資料匯入功能併入之前的早期階段，每日數量則在 130,000 至 230,000 之間。這兩組數據都可在同一份回應中看到，這正是重點所在——該服務向你展示的是其自身的增長軌跡，而非行銷上的平均數字。

趨勢：媒體目前正在報導什麼

搜尋功能回答「關於 X 寫了什麼」。趨勢功能則回答一個不同且通常更好的問題：「正在發生什麼事」——且不需要指定 X。

機器人會將文章按國家歸類為新聞故事，並保持更新。每五分鐘，新文章會根據其識別詞彙附加到已知的故事中，且完全不需要呼叫模型；每幾個小時，某個國家會經歷一次完整處理，由語言模型閱讀標題並重新命名故事。在撰寫本文時，趨勢層涵蓋了 115 個國家，每個國家的資料都在過去幾分鐘內重新計算過。

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"

{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

每個故事都附帶兩個計數，它們代表不同的意義。articles 代表聲量；publishers 代表廣度。一個擁有 200 篇文章但僅來自 4 家媒體的故事，代表單一新聞室的執著；而一個擁有 60 篇文章卻來自 40 家媒體的故事，則代表一個事件。預設排序依據為 publishers，你可以透過 min_publishers 和 min_articles 自行設定門檻。

故事會從固定類別中帶入一個分類：politics（政治）、business（商業）、markets（市場）、tech（科技）、sport（運動）、health（健康）、science（科學）、culture（文化）、crime（犯罪）、conflict（衝突）、weather（天氣）、society（社會）。

視窗由讀者決定，而非由機器人決定

這是一個真正優雅的設計決策。每篇文章都會儲存其發布時間並關聯至其所属的故事，因此任何視窗——十五分鐘、一小時、一天或特定日曆日期——都只需對同一份儲存資料進行範圍查詢即可。一次運算即可同時服務所有視窗。window=15m、window=1h、window=24h、date=2026-09-01，或明確的 since/until 配對，都能對同一個索引進行查詢而無需重新計算。

關鍵字：新聞的基石

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

每個關鍵字都會回傳帶有該關鍵字的故事數量、這些故事包含的文章數量，以及——最有趣的一項——使用該關鍵字的國家媒體數量。最後這個數字區分了全球性事件與國內事件。一個出現在七十個國家的詞彙屬於世界性新聞；一個在某國媒體中佔據主導地位的詞彙則屬於國內新聞，無論其在當地聲量多大。

哪些國家正在運作

curl "https://freenewsapi.ai/v1/trends/countries"

回傳所有受追蹤國家的即時故事數量，以及距離上次重新計算經過了多少分鐘——土耳其、俄羅斯、伊朗、希臘、印度、義大利、烏克蘭、羅馬尼亞、阿根廷、德國和巴西目前每個國家都擁有數千則即時故事，且最近十分鐘內均已重新計算。此外，/v1/trends/{cc}/{slug} 可開啟單一故事並顯示其完整文章列表。

市場與報導：一軸價格，另一軸關注度

這是該服務中最不尋常的功能，其存在是因為語料庫使得建置成本幾乎為零。將價格序列與世界在相同時間內針對該主題的報導量並列於同一條時間軸上。

curl "https://freenewsapi.ai/v1/markets"

追蹤十四種交易工具，涵蓋四個資產類別：

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

這單一呼叫即可取得里拉兌美元的匯率，以及土耳其媒體在相同期間的報導量，並按小時對齊。土耳其媒體佔此資料集的第三大比例，正因如此，這種配對才能產生有意義的結果，而非雜訊。

以及完整的比特幣情緒區塊

比特幣擁有專屬的七個端點系列，因為它是唯一一個市場對新聞語調與價格走勢的關聯性不斷爭論，卻鮮少被量化測量的標的：

情緒標籤來自一個語言模型，該模型每五分鐘對最新的加密貨幣文章進行分析，並針對經過校準的代幣清單進行比對。如果你曾想測試「新聞引發市場波動」這一說法，而非僅僅重複它，那麼 /v1/btc/correlation 端點搭配 max_shift 參數就是你要尋找的工具。

相同的搜尋，作為資訊流

另外三個端點採用相同的搜尋參數，並將結果以整合發布格式呈現，而非 JSON：

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

這意味著任何已儲存的搜尋都會變成一個資訊流，你可以將其貼入閱讀器、n8n 節點、Slack 整合、Zapier 觸發器或靜態網站生成器中——無需程式碼，也無需金鑰。這是一個不起眼的小功能，卻能為非程式設計師省去整個整合層。

MCP：二十八種工具，兩個層級

MCP 伺服器位於單一 URL，採用 Streamable HTTP（JSON-RPC 2.0，基於 POST，協議版本 2025-06-18），支援批次處理，並且——如同此處的所有其他功能——無需授權步驟，也沒有會話 ID。

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

它提供了兩個刻意設計的層級中的 28 種工具。

第一層：六個快捷方式，一次呼叫即可回答整個問題

第二層：每個端點均由服務本身生成

在捷徑之下，每個原始端點都以 API 所接受的所有參數，作為獨立工具公開——包括 news_get_search、news_get_stats、news_get_article、news_get_trends、news_get_trends_keywords、news_get_markets_slug、整個 news_get_btc_* 系列、Feed 渲染器以及 news_get_health。這些端點由即時服務生成，因此不會偏離 API 實際接受的內容。

兩個元工具（meta-tools）完成閉環：news_list_endpoints 回傳所有現有項目的目錄，而 news_get 則對任何路徑執行原始 GET——因此，當代理程式遇到其工具列表未涵蓋的端點時，仍能透過此方式存取。

curl "https://freenewsapi.ai/mcp?format=json"

只需一次 GET，無需握手協定，即可獲得整個機器可讀的目錄：包含伺服器、傳輸層、協定、工具數量、每個工具的說明，以及每個端點的參數列表。

為機器閱讀而設計

文件並非事後附加在 API 上的附加功能——它是 API 的一等公民輸出。該網站提供 665 個靜態頁面，其中幾頁專門設計，讓模型無需閱讀 HTML 即可獲取資訊：

• /openapi.json 完整的 OpenAPI 規格文件。
• /llms.txt 一份簡短的導覽檔案——說明服務內容、API 端點、查詢技巧以及錯誤代碼。
• /llms-full.txt 完整的文件內容，以單一純文字檔案呈現，容量超過一百十萬位元組，讓 AI 代理程式能透過一次請求讀取全部說明手冊。
• /agents 三十九個頁面，專門為代理程式開發者設計：提供現成的 OpenAI 函式定義、Anthropic 工具使用定義、新聞檢索用的系統提示詞（System Prompts）、RAG 實作範例、Token 成本對照表以及代理程式開發配方。
• /agents/models 針對不同模型系列的工具呼叫程式碼——涵蓋 Qwen、DeepSeek、MiniMax、Kimi、GLM、Doubao、Hunyuan、ERNIE、Yi、Step、GPT、Claude、Gemini、Grok、Mistral、Llama、Command、Nova、Phi、Jamba、Sonar、OpenRouter、Ollama 與 vLLM。
• /data 語料庫的內容說明、研究方法、索引結構，以及一篇名為〈資料品質〉的頁面，詳細記錄該資料集的錯誤與限制。
• /sources 可瀏覽的出版商目錄，包含 11,668 家出版機構，可依國家、語言與網域區隔進行篩選。
• /compare 與 NewsAPI.org、GNews.io、NewsData.io、Mediastack、Currents、TheNewsAPI、NewsCatcher、WorldNewsAPI、Perigon、APITube 及 FreeNewsAPI.io 的橫向比較頁面。

加上 168 個國家頁面、121 個語言頁面與 275 個頂級網域（TLD）頁面——針對語料庫的每個切片提供一個可瀏覽的介面，並顯示其中的實際內容。

文章的來源

兩個資料擷取路徑匯入同一個索引，兩者的差異至關重要。

封存路徑

每十分鐘便有一個作業會檢查 Common Crawl 的 CC-NEWS 封存庫，尋找新的 WARC 檔案並處理任何未見過的內容，同時使用四十個平行工作執行緒。提取器會從原始爬蟲資料中提取每篇文章，並針對每個欄位採用文件化的層級遞補策略（cascade）——且這些遞補策略是針對真實資料進行測量，而非憑空假設：

該國籍欄位是誠實的那個，這也是為何 country_source 會暴露於每篇文章的原因：約五分之一的記錄完全缺乏可靠的國籍訊號，而現有值中約三分之一屬於推論而非事實。API 會明確標示何者為推論、何者為事實，而非掩飾真相。

即時路徑

第二個機器人每五分鐘輪詢一次出版商的 RSS 供稿，並搭配條件式請求進行輪詢——若供稿回應 304 Not Modified（未修改），則幾乎不消耗資源；每個供稿的輪詢間距也會根據其實際發布頻率進行調整。若一家媒體每天發布五篇文章，就不會每十五分鐘就被過度抓取。

它僅取得出版商在供稿中提供的內容：標題、摘要，以及當供稿包含時的全篇文章。它不會進入出版商的網站去抓取更多內容。這是刻意設定的界線，也是該服務能在其面向出版商的法律頁面上做出承諾的原因。

及其周邊的機制

在兩個資料攝取路徑之外，還有 dozens 個機器人在排程中運作：來源發現與同步、依網域解析國籍、趨勢建立與稽核、關鍵字補填、加密貨幣情緒、市場資料拉取、分類目錄、保留機制（九十天的窗口是透過每晚對 published_at 執行查詢來強制執行，而非依賴索引年齡）、日期驗證、空文章重新檢查，以及監控任何已停止運作服務的運作狀態的健康防護機制。整個語料庫存放在專屬的 Elasticsearch 叢集上。

此資料集的不足之處

該服務會公布其自身的限制，這是判斷其是否適合您應用情境的最快方式。

• 國籍為推論得出 請檢視每篇文章的 country_source，並在按國籍進行統計而非瀏覽時，加入 strict_country=true 參數。
• published_at 由出版商提供 回溯日期很常見。若您正在輪詢新內容，請改用 crawled（抓取時間）進行排序。
• 總數上限為 10,000 為了提升速度。當達到上限時，total_is_lower_bound 會告知您。
• 無情緒或實體提取 除比特幣區塊外，文章不帶有任何情緒評分或命名實體。這不在範圍內。
• 最多九十天 沒有更久遠的資料庫。如果你需要 2019 年的資料，這就不是適合的工具。
• 無服務等級協議（SLA） 它是免費的。雖然有監控與保護，但沒有任何書面承諾。
• 文字歸出版商所有 每個回應都會包含原始的 URL，使用者被預期會連結回該來源。

良好使用指南：成本、分頁與錯誤處理

Token 紀律

對於 AI 代理（agent）而言，回應大小才是真正的成本。其記錄的結構如下：

二十篇文章搭配 full_text=true 大約需要 40,000 個 token。推薦的標準模式始終如一：先計數、掃描，再為需要的少數內容抓取正文。

翻頁超過上限

offset 的上限為 9,900。若要遍歷大量資料集，不要與上限硬碰硬，改為按時間區間切片。使用 from/to 與 sort=date 逐日或對熱門查詢逐小時迴圈遍歷。文件中有專門的頁面介紹如何遍歷一整天的資料。

錯誤處理

API 合約直截了當且易於實作：4xx 代表請求有誤——修正它，不要重試。5xx 代表服務不可用——退避。429 代表降速並重試。未知的查詢參數會被忽略而非拒絕，因此新增欄位絕不會導致現有呼叫端失效。

標識身份（選填，且確實可選）

若無 API Key，就無法識別呼叫端。建議的禮貌做法是透過標頭指定你的代理程式名稱、所屬框架以及驅動模型：

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

這些值同樣可以作為純查詢參數使用，通常這樣更方便：

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

未知的欄位會被忽略，因此額外傳送欄位始終是安全的。不會進行驗證，也不會因遺漏而限流，唯一的明確指示是：切勿將終端使用者的個人資料放入這些欄位。

對抗付費新聞 API

網站上的比較頁面逐一介紹了十一個競爭對手。以下是它們之間難以被取代的結構性差異：

付費服務仍提供但此處未提供的功能：作為標準欄位的情緒評分和實體提取、可追溯多年的歷史存檔，以及附有服務水平協議（SLA）的合約。這些都是真實存在的優勢，如果你需要這些功能，就應該購買付費服務。

食譜

即時國家監控

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

這則新聞是全球性還是國內性？

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

以低成本將模型建立在當前的新聞涵蓋範圍上

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

新聞涵蓋範圍是否領先價格？

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

將已儲存的搜尋結果轉換為資訊流

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

找出市場中重要的媒體 Outlet

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

簡短版本

Free News API 對來自 100 個國家、約 100 種語言的 25,000 多家出版商的 2,150 萬篇新聞文章進行全文搜尋，資料涵蓋滾動 90 天視窗並持續更新，無需金鑰、無需註冊，且除了依 IP 設定的速率限制外無其他配額。此外，還提供涵蓋 115 個國家的即時分國別故事聚類、可區分國際與國內事件的關鍵字分析、將十四種市場工具與報導量進行比對的圖表、七個端點的比特幣情緒區塊、RSS/Atom/JSON 訂閱服務，以及由該服務本身生成的 28 工具 MCP 伺服器。

它會記錄自身的錯誤率，揭露每個國家資料值的計算方式，並發布關於資料誤差的說明頁面。對於需要即時掌握全球動態（無論是用土耳其語、希臘語還是印地語）的 Agent 而言，這種組合無論花多少錢都難以找到，而這個服務是免費的。

搜尋採用所有條件的 AND 邏輯。請使用 2–5 個關鍵字，而非自然語言問句。

Free News API 關於如何有效查詢的指南

從這裡開始：freenewsapi.ai · 在 freenewsapi.ai/mcp 使用 MCP · 以單一檔案形式下載完整說明文件 /llms-full.txt。