ニュースAPIは通常、リクエストごとに課金され、APIキーで制限され、無料プランでは1日100回の呼び出しが上限となります。Free News APIはそれらの制限を一切持ちません:ローリング90日間の2,150万本の記事、25,000社以上の出版社、APIキー不要、サインアップ不要、クォータ制限なし、商用利用も可能。検索、統計、トレンド、市場、フィード、MCPなど、サービスが提供するすべての機能と、データがどのように誤解を招く可能性があるかについての実直な解説をご紹介します。
問題の構造
AIエージェントに「現在世界で何について書かれているか」を尋ねると、3つの悪い選択肢しかありません。1つ目は出版社から直接スクレイピングすることですが、これは不安定で遅く、法的にグレーゾーンです。2つ目は商業用のニュースAPIを呼び出すことで、これにはアカウント、キー、月々の請求が必要で、市場の無料プランでは1日100リクエストが上限で、記事の更新が24時間遅れることもあります。3つ目は、数ヶ月前で更新が止まったトレーニングデータから推測することです。
Free News APIは、中ほどの選択肢(商業API)のコストと手続きを削除しつつ、その能力は維持します。1回のGETリクエストで、認証情報不要、執筆時点で21,557,044本の記事を収録し、25,000社以上の出版社から収集したデータを対象とします。データはローリング90日間のウィンドウで管理され、絶えず更新されています。インデックスに追加された最新の記事は、通常2分以内のものです。
4つのコアエンドポイント、そしてさらに
サービスの核となるのは、https://freenewsapi.ai 配下の4つのGETエンドポイントです。これらはすべてUTF-8形式のJSONを返し、Access-Control-Allow-Origin: * ヘッダを付与してブラウザのコードから直接呼び出せるようにしています。また、サーバー側の処理時間は took_ms として報告されます。
| エンドポイント | 回答内容 |
|---|---|
GET /v1/search | フィルター付きの全文検索。このエンドポイントは、利用の95%で使用されます。 |
GET /v1/stats | 国、言語、TLD、出版者、日付ごとの、あらゆるスライスの集計カウント。 |
GET /v1/article | 正確なURLによる1つの記事、本文全文を含む。 |
GET /health | ライブステータスと現在のドキュメント数。ポーリングに十分な低コスト。 |
そのコアの周囲にはさらに4つのファミリーがあり、それぞれが他では単独の製品となるものです:trends(国ごとのライブストーリークラスタリング)、markets(カバレッジボリュームに対して調整された価格シリーズ)、crypto sentiment(7つのエンドポイントを持つビットコインブロック)、syndication(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"
}
]
}そのレスポンス内の3つのフィールドは、データセット全体の誠実さをエンコードしているため、すぐに注意を払う価値があります。total_is_lower_boundは、一致件数が1万の上限に達し、カウントが停止したことを示します。country_sourceは、国がどのように決定されたかを示します。なぜなら、ニュースデータセットでは、国の値の大部分が推測であり、事実ではないからです。そしてcrawled_atは信頼できるタイムスタンプです。パブリッシャーはpublished_atを日常的に遡って設定しますが、クロール時間はパイプラインによって割り当てられ、常に前方にのみ進みます。
検索:重要なすべてのパラメータ
すべてのパラメータはオプションです。パラメータを指定しない呼び出しのみでは、インデックス内の最新記事が返されます。
クエリ
- q タイトル(重み3)、説明(重み2)、記事本文と一致します。ANDセマンティクス — 各用語がすべて存在する必要があります。つまり、単語を追加すると範囲が狭くなります。最大500文字まで。
opec production cutは機能しますが、what did OPEC decide about oilは何も返しません。フィルター
フィルターはパラメータ間でのANDと1つのパラメータ内でのORで結合されます。つまり、country=DE,AT&lang=deは「ドイツまたはオーストリアからのドイツ語記事」として解釈されます。それぞれ最大50値のコンマ区切りリストを受け入れます。
| フィルター | 形式 | 注記 |
|---|---|---|
country | ISO 3166-1 alpha-2形式、大文字 | 出版社の国。宣言ではなく派生 — country_sourceおよびstrict_countryを参照。 |
lang | ISO 639-1形式、小文字 | ドキュメント自体から検出。カバー率99.9%。 |
tld | ドットなし | 出版社のドメインゾーン。tld=uaは事実、country=UAは推論。 |
host | 完全一致のホスト名 | URLに記載されている通り — 出版社がwww.を使用している場合はそれを含める。 |
date | 今日 · 昨日 · 24時間以内 · 48時間以内 · 7日間以内 · 30日間以内 | published_atに対して評価される、プリセットの期間。 |
from / to | ISO日付 | プリセットが適合しない明確な期間。 |
strict_country | true/false | 国が推測ではなく確実な事実である記事のみをカウントする。 |
出力制御
| パラメータ | 値 | 効果 |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | 新規記事のポーリング時はcrawledでソートする — 出版社は公開時刻を遡って設定することがありますが、クロール時刻は常に進行方向にしか移動しません。 |
size | 1–100 | 1ページあたりの結果数。 |
offset | 0〜9900 | ページネーションのオフセット。 |
full_text | true/false | 記事本文を含める。デフォルトはオフ。 |
highlight | true/false | 一致した断片を返す。 |
fields | CSV | 実際に使用するフィールドにのみ応答を絞り込む。 |
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 です。しばしば重要な質問は「記事は何ですか」ではなく、「ここには何かが存在するのか、そしてそれはどこにあるのか」といったものです。カウントは、結果ページを取得する際に必要となる数千トークンに対して、わずか200トークン程度のコストで回答するため、エージェントが検索を実行する価値があるかどうかを判断するための最初の呼び出しとして最適です。
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"国、言語、TLD、出版者、日付ごとのカウントを返します。これは現在のページではなく、一致するすべてのセット全体に対して計算されます。これこそが、信頼する前にカバレッジを測定する方法でもあります。執筆時点でのフィルタリングなしのスナップショットは以下の通りです:
主要国
| 国 | 記事数 |
|---|---|
| インド | 2,286,014 |
| アメリカ合衆国 | 2,180,797 |
| トルコ | 1,499,897 |
| ロシア | 1,436,556 |
| イタリア | 1,057,479 |
| アルゼンチン | 826,947 |
| スペイン | 812,347 |
| ウクライナ | 662,041 |
| ブラジル | 551,013 |
| ドイツ | 543,132 |
| フランス | 502,846 |
| ギリシャ | 460,372 |
| 日本 | 437,209 |
| ベトナム | 408,934 |
| メキシコ | 402,320 |
| 韓国 | 362,945 |
| ルーマニア | 354,229 |
| イギリス | 334,379 |
| イラン | 291,782 |
| ポーランド | 255,599 |
主要言語
英語 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件。
この分布は少し注目する価値があります。なぜなら、これは多くのニュースAPIがあなたに提供しているものとは正反対だからです。通常、英語ファースト、米国ファーストのコーパスとは異なり、インドが米国を上回り、トルコ語がドイツ語を上回り、ギリシャ語、ベトナム語、ペルシャ語、ブルガリア語も6桁の件数で表現されています。もしあなたの質問が英語以外のプレスに関するものであれば、これは実質的に異なるデータセットです。
ボリューム
by_dayの daily curve は90日間の全期間をカバーしています。最近の日はおおよそ1日あたり40万〜70万記事の範囲に位置しています。RSSレイヤーがアーカイブ取り込みと同時に追加される前の期間では、1日のボリュームは13万〜23万でした。両方の数字が同じレスポンスで確認できることがポイントです — このサービスはマーケティング上の平均値を引用するのではなく、自身の成長曲線を示します。
トレンド:今、メディアが実際にカバーしているもの
検索は「Xについて何かが書かれたか」に答えます。トレンドは、より適切で異なる質問に答えます:「何が起きているか」 — Xは必要ありません。
ロボットが記事を国ごとにストーリーにクラスタリングし、更新を維持します。5分ごとに、識別語に基づいて新しい記事が既知のストーリーに接続されます。モデル呼び出しは一切行われません。数時間ごとに、国ごとに言語モデルが見出しを読み、ストーリーをゼロから命名するフルパスが実行されます。執筆時点で、トレンドレイヤーは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": [ … ]
}
]
}各ストーリーには2つのカウントが伴い、それぞれが異なる意味を持ちます。articlesは「音量(注目の度合い)」を、publishersは「広さ(メディアの多様性)」を表します。4社のメディアから200記事のストーリーは、ある新聞社の執念を示しています。一方、40社のメディアから60記事のストーリーは、イベントそのものです。デフォルトのソートは出版社数で行われ、min_publishers / min_articlesで基準値を自由に設定できます。
ストーリーは、politics(政治)、business(ビジネス)、markets(市場)、tech(テクノロジー)、sport(スポーツ)、health(健康)、science(科学)、culture(文化)、crime(犯罪)、conflict(紛争)、weather(天気)、society(社会)という固定されたセットからカテゴリを1つ持ちます。
ウィンドウはロボットではなく、読者の選択です
これは真に洗練された設計上の判断です。すべての記事は、発行時刻とともに保存され、ストーリーに紐付けられます。そのため、15分、1時間、1日、特定の暦日など、いかなるウィンドウも、同じ保存データに対する単なる範囲クエリとして扱えます。1回の計算で、すべてのウィンドウに対応できます。window=15m、window=1h、window=24h、date=2026-09-01、あるいは明示的な since/until の組み合わせは、すべて同じインデックスに対して再計算なしで動作します。
キーワード:ニュースを構成する言葉
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"各キーワードには、それを含む固有のストーリー数、それらのストーリーに含まれる記事数、そして――興味深い点として――それを使用している国の新聞社数が返されます。最後の数字は、グローバルなイベントか国内のイベントかの違いを示します。70カ国で出現する言葉は世界規模のストーリーであり、ある1カ国の新聞を支配する言葉は、たとえその国で大きく取り上げられていようとも、国内のストーリーです。
ライブ状態の国々
curl "https://freenewsapi.ai/v1/trends/countries"追跡対象のすべての国を、ライブストーリーの数と最終再計算から何分前かという情報とともに返します。トルコ、ロシア、イラン、ギリシャ、インド、イタリア、ウクライナ、ルーマニア、アルゼンチン、ドイツ、ブラジルなどはすべて、現在それぞれ数千のライブストーリーを抱えており、直近10分以内に再計算されています。また、/v1/trends/{cc}/{slug} は、単一のストーリーとその完全な記事リストを開きます。
市場と報道:一方の軸に価格、もう一方の軸に注目を
これがサービスで最も珍しい点であり、コーパスが構築をほぼ無償にできるため存在します。ある物事について世界が同じ時間帯にどれほど書いたかという量と、その価格シリーズを1つのタイムライン上に並べます。
curl "https://freenewsapi.ai/v1/markets"4つの資産クラスにまたがり、14の銘柄を追跡しています:
| クラス | 銘柄 | 粒度 | ソース |
|---|---|---|---|
| 暗号通貨 | ビットコイン、イーサリアム、ソラナ、XRP、BNB、ドージコイン | 時間 | バイナンス |
| 金属 | ゴールド(USD/oz) | 時間 | バイナンス |
| 外国為替 | EUR/USD、USD/JPY、USD/TRY、USD/INR、USD/BRL、USD/PLN | 日 | ECB(欧州中央銀行) |
| エネルギー | ドイツの電力価格(EUR/MWh) | 時間 | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"この1つの呼び出しにより、ドルに対するリラのレートと、同じ期間のトルコ系メディアの報道ボリュームを時間単位で一致させることができます。トルコ系メディアはこのコーパスの3番目に大きな構成要素であり、だからこそこの組み合わせはノイズではなく意味のあるデータを生成するのです。
そして、ビットコインのセンチメント(感情分析)ブロック全体
Bitcoinには独自の7つのエンドポイントからなるファミリーが用意されています。これは、ニュースのトーンと価格変動が絶えず議論され、ほとんど測定されていない唯一の銘柄だからです。
| エンドポイント | 戻り値 |
|---|---|
/v1/btc/summary | 最新の価格、直近の動き、および今日の報道のトーン。 |
/v1/btc/price | インターバルごとのBTC/USDTローソク足。 |
/v1/btc/sentiment | 期間ごとのニュースのトーン。 |
/v1/btc/series | 価格とトーンを1つのタイムライン上に統合。 |
/v1/btc/correlation | タイムシフトごとのトーンと価格変動の相関関係 — 報道が価格に先行しているのか、それとも追従しているのか? |
/v1/btc/news | 感情ラベル付きの暗号通貨記事。ラベル、ホスト、言語、クエリでフィルタリング可能。 |
/v1/btc/sources | 暗号通貨の報道を担うメディアはどれで、それぞれがどのような傾向を持っているか |
感情のラベルは、5分ごとに最新の暗号通貨記事に対して調整済みのコインリストを用いて実行される言語モデルから取得されます。「ニュースが価格変動を引き起こす」という主張を繰り返すのではなく、実際に検証したい場合は、max_shift パラメータを指定した /v1/btc/correlation エンドポイントを利用してください。
同じ検索結果をフィードとして
さらに3つのエンドポイントは、同じ検索パラメータを受け取り、JSONではなくシンジケーション形式で結果をレンダリングします:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Feed 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateつまり、保存した検索クエリは、コードやAPIキーなしで、リーダー、n8nノード、Slack統合、Zapierトリガー、または静的サイトジェネレーターに貼り付けて利用できるフィードになります。これは、非エンジニアにとって統合レイヤー全体を静かに不要にする小さな機能です。
MCP: 28のツール、2つのレイヤー
MCPサーバーは単一のURLに存在し、Streamable HTTP(POST経由のJSON-RPC 2.0、プロトコルバージョン2025-06-18)に対応し、バッチ処理をサポートします。また、ここにある他の機能と同様に、認証ステップやセッションIDも不要です。
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp28のツールが2つの意図的なレイヤーで公開されています。
レイヤー1:1回の呼び出しで質問全体に答える6つのショートカット
| ツール | 用途 |
|---|---|
search_news | 「Xについて何が書かれたか」— 全文検索、結果を要約 |
get_trends | 「今何が起こっているか」 — 記事のリストではなく、グループ化されたストーリー。 |
trend_keywords | 現在ニュースの基盤となっている単語、ストーリー数、および国別の分布。 |
find_publishers | 媒体の検索:名前、ドメイン、国、言語、1日あたりの記事数。 |
list_countries | ライブストーリーが存在する国、その数、および最新性。 |
market_vs_news | 価格系列とカバレッジボリュームの比較。対象の銘柄を指定せずに呼び出すと、存在するデータを確認できます。 |
レイヤー2:サービス自体から生成されるすべてのエンドポイント
ショートカットの下方には、生のエンドポイントが個別のツールとして公開されています。API が受け付けるすべてのパラメータを備えた news_get_search、news_get_stats、news_get_article、news_get_trends、news_get_trends_keywords、news_get_markets_slug、news_get_btc_* 全体ファミリー、フィードレンダラー、および news_get_health です。これらはライブサービスから生成されるため、API が実際に受け付ける内容とズレることはありません。
ループを完成させる2つのメタツールがあります。news_list_endpoints は存在するすべてのカタログを返し、news_get は任意のパスに対して生 GET を実行します。そのため、ツールリストでカバーされていないエンドポイントに遭遇しても、エージェントはそれらに到達できます。
curl "https://freenewsapi.ai/mcp?format=json"GET を1回実行するだけで、ハンドシェイクは不要です。サーバー、トランスポート、プロトコル、ツール数、各ツールの説明、および各エンドポイントのパラメータリストを含む、機械可読なカタログ全体が取得できます。
機械が読み込むために構築された
ドキュメントは API に後から付け加けられたおまけではありません。それは API の主要な出力物です。サイトは665ページの静的ページを配信しており、そのいくつかはモデルがHTMLを読む必要がないように特別に存在しています:
- /openapi.json OpenAPIの完全なスキーマ。
- /llms.txt サービスの概要、エンドポイント、効率的なクエリ方法、エラーに関する短いオリエンテーションファイル。
- /llms-full.txt 100キロバイト以上の大容量となる完全なドキュメントを1つのプレーンテキストファイルとして提供し、エージェントが一度のフェッチでマニュアル全体をインポートできるようにします。
- /agents エージェント開発者向けに作られた39ページ:事前に用意されたOpenAI関数定義、Anthropicのツール使用定義、ニュース取得用のシステムプロンプト、RAGレシピ、トークンコスト表、エージェントレシピが含まれています。
- /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ページを追加。コーパスの各セグメントごとに閲覧可能なインターフェースを提供し、各ページに実際に何が含まれているかを表示します。
記事の出所
2つの取り込みパスが同じインデックスにデータを供給しますが、その違いは重要です。
アーカイブパス
10分ごとにジョブがCommon CrawlのCC-NEWSアーカイブを確認し、未処理のWARCファイルを探します。見つかった場合は、40の並列ワーカーを使用して処理を行います。抽出器は、フィールドごとに文書化された優先順位(カスケード)に基づいて、生データから記事を抽出します。この優先順位は、仮定ではなく実際のデータを用いて測定されました:
| フィールド | 優先順位(カスケード) | カバレッジ |
|---|---|---|
| description | JSON-LD → meta → OpenGraph → Twitter card → articleBody → リード文 | 98.1% |
| language | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| country | ccTLD → JSON-LD addressCountry → 言語-地域 → og:locale | 79.1% |
| date | JSON-LD datePublished → meta → trafilatura → クロール時刻 | 100% |
この国別データは誠実なものであり、それが country_source がすべての記事で公開されている理由です。記録の約5分の1には信頼できる国別シグナルがなく、存在する値の約3分の1は事実ではなく推測によるものです。API は、どちらがどちらなのかを偽らずに教えてくれます。
ライブパス
2番目のロボットは、条件付きリクエスト付きのローテーションで、RSS フィードを5分ごとにポーリングします。304 Not Modified を返すフィードはほぼコストがかからず、各フィードのポーリング間隔は、実際に記事が公開される頻度に合わせて調整されています。1日に5記事を投稿するメディアは、15分ごとにアクセスされるわけではありません。
また、フィードに含まれるタイトル、リード、およびフルテキストのみを取得します。パブリッシャーのサイトへアクセスして追加情報を取得することはありません。これは意図的な境界線であり、そのサービスがパブリッシャー向けの法的不実表示ページで約束できる理由です。
それらを取り巻く仕組み
2つの取り込みパスの周囲には、スケジュールに基づいて動作する12個以上のロボットが配置されています。これらには、ソースの発見と同期、ドメインごとの国別解決、トレンドの構築と監査、キーワードのバックフィル、仮想通貨のセンチメント、市場データの取得、分類カタログ、保持(90日のウィンドウはインデックスの年齢ではなく、published_at に対する夜間のクエリによって強制されます)、日の検証、空の記事の再チェック、停止したものを再起動するヘルスガードが含まれます。コーパスは専用 Elasticsearch クラスター上にあります。
このデータセットが誤っている点
このサービスは独自の制限事項を公開しており、それがあなたの問題に適合するかどうかを判断する最も速い方法です。
- 国別データは推測によるものです すべての記事で
country_sourceを読み取り、国別でカウントする場合はstrict_country=trueを追加してください。 - published_at はパブリッシャーが提供 日付の遡りは一般的です。新しいコンテンツをポーリングする場合は
crawledでソートしてください。 - total は 10,000 に制限 速度のためです。
total_is_lower_boundは、上限に達したときにあなたに知らせます。 - センチメントやエンティティ抽出はなし ビットコインのブロック外では、記事にはセンチメントスコアも固有エンティティも含まれません。これは範囲外です。
- 90日間、それ以上は不可 それ以上のアーカイブはありません。2019年のデータが必要であれば、これは適切なツールではありません。
- SLAなし 無料です。監視と保護は行われていますが、書面での保証はありません。
- テキストの著作権は発行者にあります すべての応答には元のURLが含まれており、呼び出し元はそれへのリンクを張ることが求められます。
効果的な利用法:コスト、ページネーション、エラー
トークン管理の徹底
エージェントにとって、応答のサイズが実際のコストとなります。文書化されたその形状は以下の通りです:
| 呼び出し | 概算トークンコスト | いつ |
|---|---|---|
/v1/stats | 約200 | まず、検索を実行する価値があるかどうかを判断します。 |
/v1/search メタデータのみの場合 | ページあたり数千件 | スキャンして選択する。 |
/v1/search?full_text=true | 記事あたり約900件 | 実際に選択した限られた記事のみを対象とします。 |
full_text=trueを指定して20記事取得すると、トークンは約40,000になります。推奨されるパターンは常に同じです。件数をカウントし、スキャンしてから、必要な記事のみを取得します。
上限を超えたページネーション
offsetは9,900で上限に達します。大量のデータを取得する際は、上限と戦うのではなく、時間単位でスライスしてください。from/toとsort=dateを使用して、1日単位、またはクエリが活発な場合は1時間単位でループ処理します。ドキュメントには、1日分のデータを取得するための専用ページがあります。
エラー
契約条件は明確で、実装も容易です。4xxはリクエストに問題があることを意味し、修正して再試行しないこと。5xxはサービスがダウンしていることを意味し、バックオフすること。429は、スローダウンして再試行すること。未知のクエリパラメータは拒否されるのではなく無視されるため、フィールドを追加しても既存の呼び出し元が破綻することはありません。
自己紹介(任意、かつ本当に任意)
キーがない場合、呼び出し元に到達する方法はありません。推奨される礼儀として、エージェント名、実行フレームワーク、モデル名を記載するヘッダーを使用します:
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への対抗
サイト上の比較ページでは、11社の競合他社が個別に紹介されています。それらすべてに共通する構造的な違いは以下の通りです:
1日100リクエスト、24時間の遅延
無料ニュースAPIプランの標準的な形:デモ用途には小さすぎるトークンバケットと、有料顧客向けに保留されている最新記事
- APIキー必要
- 1日のリクエスト上限
- 遅延配信記事
- 非商用のみ
上限なし、遅延なし、キー不要
IPアドレスごとに秒間20リクエストが唯一の制限。最新記事は通常2分以内に更新され、商用利用も可能です。
- キー不要、サインアップ不要
- 1日・月間のリクエスト上限なし
- 継続的な自動更新
- 商用利用可
英語・米国中心
大半のコーパスは、英語圏の出版社リストをベースに、その他の地域のデータが追加されて構築されています。
- 英語が支配的
- 非ラテン文字圏のカバレッジが薄い
インド > 米国、トルコ語 > ドイツ語
ギリシャ語、ベトナム語、ペルシャ語、ウクライナ語、ブルガリア語などで6桁のボリュームを誇る、約100言語。
- 100カ国
- 約100言語
- 11,668件のカタログ化されたソース
有料サービスがまだ提供しており、こちらが提供していないもの:感情スコアやエンティティ抽出を標準フィールドとして備えていること、数年にわたるアーカイブ、そして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モデルを今日のニュースで低コストに grounds する
# 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市場で重要なニュースソースを特定する
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は、90日間のローリングウィンドウで継続的に更新される、100カ国・約100言語の2万5000以上の出版社から収集した2150万本以上のニュース記事に対するフルテキスト検索サービスです。APIキー、サインアップ、クォータ(IPごとのレート制限のみ)が不要です。検索機能に加え、115カ国を対象としたリアルタイムの国別ニュースクラスタリング、世界情勢と国内情勢を区別するキーワード分析、カバレッジ量に対する14種類の市場指標の可視化、7エンドポイントからなるビットコイン感情分析ブロック、任意のクエリに対するRSS/Atom/JSONの配信、およびサービス自身から生成された28ツールのMCPサーバーが備わっています。
自らのエラー率を文書化し、各国の値がどのように導出されたかを公開し、データが誤っている箇所についてもページを公開しています。トルコ語、ギリシャ語、ヒンディー語など、現在の世界の動向を把握するエージェントにとって、この組み合わせはあらゆる価格帯で手に入るものではありませんが、このサービスは無料です。
検索はすべての用語に対してAND条件で実行されます。自然言語の質問ではなく、2〜5語のキーワードを使用してください。
Free News APIによる、効果的なクエリ方法
ここから始めましょう:freenewsapi.ai · freenewsapi.ai/mcp でMCP · /llms-full.txt でマニュアル全体を1つのファイルとして入手。