Brave Search APIキー:取得して最初の検索を行う
Brave Search APIキー
Brave Search APIキー:プラン、最初のリクエスト、エージェントでの利用 | We.Inc
Brave Search APIキーを取得し、2026年10月時点のプランを確認して、X-Subscription-Tokenヘッダーで最初のリクエストを送り、AIエージェントにウェブ検索ツールを持たせる方法を解説します。
Brave Search APIのページで登録し、プランを選んで、APIダッシュボードでキーを作成します。キーを X-Subscription-Token ヘッダーに入れ、q パラメーターに検索語を指定して https://api.search.brave.com/res/v1/web/search に送ります。2026年10月時点で、Searchプランは1,000リクエストあたり$5で、毎月$5分の無料クレジットが含まれます。
Brave Search APIのプラン(2026年10月時点、brave.com/search/api)
- 料金
- 1,000リクエストあたり$5
- 1,000リクエストあたり$4、さらに入出力100万トークンあたり$5
- Braveに問い合わせ
- レート制限
- 1秒あたり50クエリ
- 1秒あたり2クエリ
- 記載なし
下でリクエストを作成しましょう。検索語を入力し、結果の件数とセーフサーチのレベルを選んで、curlコマンドかfetchのスニペットをコピーします。キーの欄が自動で埋まることはありません。サーバー上でプレースホルダーを自分のキーに置き換えてください。
- Brave Search APIのページを開き、「Get API key」を選んでAPIダッシュボードに移動します。
- プランを選びます。Braveのドキュメントにはすべての画面が説明されているわけではないため、請求とキーについてはダッシュボードの案内に従ってください。
- キーをコピーし、サーバーの環境変数として保存します。フロントエンドのコードには絶対に入れないでください。
- X-Subscription-Token ヘッダーにキーを入れてウェブ検索エンドポイントを呼び出し、JSONの応答から web.results を読み取ります。
- web.results の各結果には title、url、description が含まれており、エージェントに必要なのはたいていそれだけです。
- count は1ページあたり最大20件、offset は最大9までなので、1つのクエリでたどれるページ数には限りがあります。
- safesearch のデフォルトは moderate です。子どもが使う可能性のあるツールでは strict に設定しましょう。
- 毎月の$5のクレジットは、公表されている料金でSearchのリクエスト約1,000件分に相当し、テストや小規模なサイトには十分です。
- 繰り返される質問への回答は自分の側でキャッシュしましょう。リクエストはすべて請求の対象になります。
よくある質問
Brave Search APIは無料ですか?
無制限ではありません。2026年10月時点で、Searchプランは1,000リクエストあたり$5が請求され、毎月$5の無料クレジットが含まれるため、軽い利用なら費用はかかりません。
キーはどのヘッダーで送りますか?
X-Subscription-Token です。Braveの例では、毎回の呼び出しでリクエストヘッダーとして送っています。URLにキーを含めることはありません。
AIエージェントのウェブ検索ツールとしてBrave Searchを使えますか?
はい。エージェントのフレームワークが呼び出せる関数でリクエストを包み、タイトル、リンク、説明を返して、何を読むかはエージェントに選ばせます。Braveはこの用途向けに作られたLLMコンテキストのエンドポイントも提供しています。
Answersプランとは何ですか?
Answersはリンクの一覧ではなく、文章の回答を返します。料金は1,000リクエストごとと100万トークンごとにかかり、レート制限は1秒あたり2クエリと低めです。
サイトのフロントエンドからAPIを呼び出せますか?
訪問者がページのコードからキーを読めてしまうため、避けるべきです。サーバーかサーバーレス関数から呼び出し、ブラウザーには結果だけを送りましょう。
ドキュメントに出てくるエンドポイント
- ウェブ検索は /res/v1/web/search にあります。画像、動画、ニュースには /res/v1/ の下にそれぞれ専用のパスがあり、/res/v1/llm/context にあるLLMコンテキストのエンドポイントは言語モデル向けに整えたテキストを返します。
- どれも同じキーとヘッダーを使うため、1つのキーでプランに含まれる各エンドポイントを利用できます。
エージェントに検索ツールを持たせる
エージェントが呼び出せる小さな関数です。キーはサーバーに置いたまま、エージェントに必要なものだけを返します。
webSearch ツール関数
検索文字列を受け取るツールとして、エージェントのフレームワークに登録してください。
リクエストビルダー
検索語
パン屋 サイト アイデア
結果の件数(1〜20)
セーフサーチ
オフ
標準(デフォルト)
厳格
fetch(サーバー側)
Searchプランの月額費用
1か月あたりのリクエスト数
2026年10月時点の料金で、毎月の無料クレジットを差し引いて約${v}です。
コピー
コピーしました
無料で始める · クレジットカード不要
関連: ガイド|Webマーケティングと集客を学ぶ
製品
ご利用いただける方
機能
リソース
会社情報
サイトマップを見る