Brave Search APIをニュースAPIとして使用する

開発者の間で、Brave Search API は何よりもビッグテック企業からの独立性が高いことで知られています。すべての検索結果を自社インデックスから提供し、スクレイピングを必要としない数少ない公開検索APIのひとつだからです。 それに加えて、AIモデルの生成結果をグラウンディングするための主要な選択肢でもあります。 あまり知られていないことですが、このAPIは優れたニュースAPIとしても機能することが可能です。単一のRESTエンドポイントを通じて、最新の構造化されたニュースを、ウェブ全体から簡単なプログラム方法で取得することができます。 BraveのニュースAPI は、ニュースアグリゲーターやメディア監視ツール、常に最新の状態を維持する必要があるAIアシスタントの開発に有用です。

この記事では、Brave Search APIがニュースAPIとしてどのように機能するかをガイドします。具体的には、ニュース専用のエンドポイントがどのような役割を果たすか、どのようなデータを返すか、どのようなユースケースに適しているか、そして最初のAPI呼び出しを行う方法について説明します。

ニュースAPIとは?

ニュースAPIは、開発者がRESTエンドポイントを介して、ニュース記事を構造化されたJSON形式でクエリ・取得できるサービスです。 脆弱なカスタムコードを使ってニュースサイトをスクレイピングせずに、キーワード、日付、ソース、言語、国ごとに、世界中のニュースをフィルタリングするのに役立ちます。

ニュース専用のAPIを含む、Brave Search API

Brave Search APIは、ウェブ、画像、動画のエンドポイントと並び、/news/search に専用のニュース検索APIを提供しています。 クエリといくつかのオプションのフィルタを送信すると、APIは最新かつ関連性の高いニュース記事のクリーンなJSONペイロードを返します。 各記事には、タイトル、URL、ソース、説明、出版日、および、(オプションにより)追加コンテンツの抜粋が含まれます。

また、最新の速報ニュースの公開を助ける、is_news_breakingis_live といったプロパティも含まれています。

でも、BraveのニュースAPIが他と一線を画すのは、検索結果がどこから来ているかという点にあります。 Braveが使用しているのは、400億ページ以上に及ぶ独自の独立したファーストパーティインデックスです。リクエスト時に、他の検索エンジン検索結果のスクレイピングや、ニュースサイトのスクレイピングは行いません。 この独立性はニュースAPIにとって、より一貫性のある結果が得られること、そして変更やアクセス遮断の可能性がある第三者への依存が一切ないことを意味します。

Braveのニュース検索APIの仕組み

the news search API は、ほんの数ステップで利用することができます:

  1. クエリを送信:検索語句とAPIキーを指定して、/news/searchエンドポイントにリクエストを送信します。 トピック、企業、イベント、その他自分が知りたいあらゆることをクエリできます。
  2. 日付、国、言語でのフィルタリング:オプションのパラメータを使用すると、更新時期(例えば、過去24時間や過去1週間など)、対象国、言語といった詳細なクエリ条件で検索結果を絞り込むことができます。 これこそが、広範囲な検索を的を絞ったニュースフィードに変えるための要素なのです。
  3. 構造化された結果を取得:エンドポイントは、構造化されたJSONペイロード(コードで確実に利用できる、一貫性のあるフィールドを持った記事リスト)をレスポンスとして返します。 HTMLの解析も、スクレイピングの維持も不要です。取得したデータは、そのまま保存や表示ができます。あるいはモデルに渡してエンドユーザー向けの回答を作成することもできます。
  4. AIに追加のスニペットを使用: それぞれの結果にはいくつかの追加の抜粋を含めることができるため、モデルは記事ごとに複数箇所を扱うことが可能です。 従ってニュースAPIは要約や検索強化生成(RAG)に極めて適しており、より豊かなコンテキストをより良い回答につなげることができます。

リアルタイムの最新性と世界的な網羅性

Brave Searchのインデックスは、ウェブを継続的にクロールしているのに加え、Web Discovery Project (WDP)を通じて、実際のユーザーから定期的な情報提供を受けています。 こうしたインデックス構築の仕組みにより、インデックスは常に最新の状態に保たれています。Brave Search APIが、キャッシュされたコンテンツを遅れて配信するフィードとは異なり、真のリアルタイムニュースAPIであるのはこのためです。 最新ニュースのフィルターを使えば、過去24時間以内の速報記事を表示したり、過去1週間のトピックを追跡したり、独自の期間を設定して公開日をフィルタリングすることができます。 今朝のトップニュースでも、特定期間内の報道でも、自分で自由に指定できます。

タイムリーかつ広範囲にニュースを網羅。 Braveのニュース検索結果は、各国・多言語の信頼性の高いメディアを網羅しており、国や言語ごとのターゲティング機能が組み込まれています。 この広範な網羅性は、現代の新聞APIを定義します。つまり地域ごとのフィードや従来のシンジケーションをつなぎ合わせるのではなく、ひとつのエンドポイントを介して世界中のデジタルニュースルームから情報を取得し、地域や言語を問わず、速報はもちろんリサーチを支える十分なアーカイブの蓄積も備えているのが、新たな時代の新聞APIなのです。

ニュースAPIの一般的な利用例

Brave News APIは、以下のような幅広い実世界のプロジェクトで活用できます:

  • ニュースアグリゲーターのパイプライン:世界中の多言語のニュースを収集し、ユーザー層に合わせて再ランク付けするニュースアグリゲーターが構築できます。 Goggles を使用して、クエリ実行時に信頼できるドメインを優先したり、その他のドメインをフィルタリングしたりすることができます。そのためニュースアグリゲーターAPIのスケーリング機能は、後から追加されるのではなく、プラットフォームにネイティブに組み込まれています。
  • メディアモニタリング:ブランド、人物、トピックについて、さまざまなメディアをほぼリアルタイムで追跡し、最新情報のフィルターを使って新しい報道が掲載され次第、すぐにキャッチします。
  • トレンドと最新ニュース分析: 構造化された記事をアナリティクスやダッシュボードにフィードして、ストーリーの展開を追跡します。
  • リサーチとアーカイブ:日付によるフィルタリング機能を活用して、あるテーマに関する報道がどのように変化したかを時系列で調べられます。
  • AIグラウンディング:モデルに対し引用可能な最新ニュースを提供することで、単なる学習データだけでなく、現在の世界状況が回答に反映されるようにします。

プライバシーと独立性

Braveブランドの約束(プライバシー、独立性、常にユーザーを優先)は、ニュース API でも変わりません。 Brave Search APIの結果は、スクレイピングからではなく、自社のi独立したウェブインデックスに基づいているため、真のゼロデータリテンション(ZDR)を実現し、より明確なコンプライアンスを確保できます。 これは、ニュースAPIが規制対象の製品や企業データパイプライン内に組み込まれている場合、特に有用です。また、「独立性」とは、あなたのニュースフィードが第三者の利用規約に依存していないことを意味します。つまり、thエンドユーザー向けBrave検索エンジン が使用するのと同じインデックスが、ニュースAPIの検索結果にも使われるのです。

はじめに:ニュースAPIキーと最初のリクエスト

ほんの数分で始められます。

  1. ニュース API キーを取得: Brave Search API ダッシュボード に登録し、キーを生成します。 各プランには、有料プランへの加入を決める前にプロトタイプを作成するのに十分な、月当たり5ドルの無料クレジットが含まれています。実質、開発者のための真にf無料のニュースAPIといえるでしょう。
  2. ニュース検索 API を呼び出し: クエリとフィルタを使用して、 /news/search にリクエストを送信します。

例えば、cURL を使った最小限のリクエストは、次のようなものになるでしょう:

curl "https://api.search.brave.com/res/v1/news/search?q=climate+summit&freshness=pd" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Python からも、ニュース API をさっと呼び出せます。 以下の例では、インポートリクエストを使用し、フィルタをパラメータとして渡し、ステータスコードをチェックし、response.json() を使用して JSON ペイロードを解析しています。

import requests
url = "https://api.search.brave.com/res/v1/news/search"
params = {"q": "artificial intelligence", "freshness": "pw", "country": "us"}
headers = {
    "Accept": "application/json",
    "X-Subscription-Token": "<YOUR_API_KEY>",
}
response = requests.get(url, params=params, headers=headers)
print(response.status_code)   # 200 on success
data = response.json()        # structured JSON payload
for article in data["results"]:
    print(article["title"], article["url"])

ここから、クエリのフィルタリング(更新日、国、言語)を調整したり、より詳しいコンテキストを把握するために追加のスニペットをリクエストしたり、Gogglesを使って再ランク付けを行ったりすることができます。 以上のすべてを、Braveの独立したインデックスから、同じ低レイテンシのRESTエンドポイントに対して行うことができます。

Brave Search APIがニュースAPIとして機能する理由

Brave Search APIは、単なるウェブ検索ツールではありません。独立したインデックスを基盤とした、リアルタイムでグローバルな、プライバシーを尊重したニュースAPIです。 結果は構造化され、AIに対応しています。世界中・多言語の評価の高いメディアを網羅し、日付、国、言語で正確にフィルタリングすることができます。結果はファーストパーティのソースから来たものであり、信頼できます。 スクレイピングを行わずに、またサードパーティに管理権限を委ねることなく、最新のニュースデータを入手したい。Brave Search APIはそんなチームに最適なニュースAPIです。

さぁ、着手しませんか? Brave Search API を検討し、毎月の無料クレジットを使って、ニュースエンドポイントをお試しください。

よくあるご質問

Braveは無料ニュースAPIを提供していますか?

ある意味では、提供していると言えます。 Brave Search APIプランには、それぞれ毎月5ドル分の無料クレジットが含まれており、この無料分を超えないよう、利用制限を設定することができます。 これによりthe news APIは、無料でプロトタイプを作成したい開発者は、実質的に無料のニュースAPIとして機能させることができます。

BraveのニュースAPIはリアルタイムですか?

はい. Brave Searchはウェブを継続的にクロールし、Web Discovery Projectを通して実際のブラウザユーザーから匿名の情報を受け取っています。これにより、Brave Search ニュースAPIはリアルタイムのニュースAPIとして機能し、最新ニュースのオンライン公開から数分以内に更新されることもよくあります。 更新日のフィルターを使用すると、過去24時間、過去1週間、または任意の日付範囲のデータを抽出できます。

Brave Search news API を使用してニュースアグリゲータを構築するには?

Brave Search News API を使用してニュースアグリゲーターを構築するには、国や言語フィルタを使って /news/search をクエリするだけで、幅広い範囲をカバーできます。 次に、 Goggles を使って、優先するウェブサイトに基づいて結果を再ランク付けします。

Braveは新聞のAPIとしても機能しますか?

はい. 世界中のメディアを網羅し、日付フィルタリング機能でアーカイブを深く利用できるBrave Search APIは、速報ニュースから歴史的調査まで対応できるニュースAPIとして活用できます。

PythonでもBraveのニュースAPIを使えますか?

はい. このページの前半で紹介したPythonでのニュースAPIサンプルにあるように、リクエストを数行書くだけで、エンドポイントへのクエリ実行やJSONペイロードの解析を行うことができます。

Google公式のニュースAPIはありますか?

いいえ. Googleでは公式のGoogle News APIを提供していません。このため開発者はGoogle Newsのデータを取得するために、しばしばサードパーティ製のツールやスクレイパーベースのAPIを利用します。 Brave Search APIはこれに代わり、独自のインデックスから直接ニュースを提供する、ファーストパーティの手段です。

検索APIはどのようにして、AIに現在の出来事のコンテキストを与えるのですか?

AIモデルの訓練は決められたカットオフ日で終了するため、現在の出来事に関する質問に自力では答えられません。 検索APIはこのギャップを埋めることができます。クエリ実行時に最新の構造化されたニュースを取得することで、現在の出来事に関する最新のコンテキストをモデルに提供します。これにより回答には、トレーニング中に学習したことだけでなく、現在起きていることも反映されるようになります。 Brave Search APIのようなニュースAPIは、グラウンディングや検索強化生成(RAG)のための、自然な基盤となるのです。

関連記事

インターネットをもっと快適にしませんか?

Braveのブラウザは使いやすいだけでなく、デフォルトで広告をブロックし、世界中の人々に、よりクリーンで、速く、安全なウェブ体験を提供します。