Brave Searchのウェブ結果、関連検索キーワード、ディスカッション、動画、ニュース、画像結果、ナレッジカードデータを構造化JSONとして収集し、代替検索エンジンのモニタリング、順位チェック、エージェントネイティブなワークフローに活用できます。
構造化出力
CrawloraのBrave Search APIを使えば、対応する公開Brave Searchページから得られる構造化結果で、検索モニタリング、ブランドトラッキング、エージェントネイティブなワークフローのデータを拡充できます。Crawloraはレスポンスフィールドを正規化し、エンドポイント別のドキュメント、Playgroundのサンプル、ドキュメント化されたエラー挙動を提供します。
SERPワークフロー
Brave Searchが表示するドメイン、ディスカッション、動画、コンテキストモジュールは他のエンジンと異なる場合があります。Crawloraは、独立したスクレイピングインフラを維持することなく、Braveの順位チェックをGoogle・Bingのモニタリングと組み合わせるチームを支援します。
SERPモニタリングワークフローリクエストスキーマ
これらのパラメータは、稼働中の「Search Brave」カタログエントリから取得しています。
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| q | string | はい | Search query | - |
| country | string | いいえ | Brave result country; defaults to us | - |
| lang | string | いいえ | Brave UI language; defaults to en-us | - |
| offset | integer | いいえ | Zero-based Brave result page | - |
| time_range | string | いいえ | Preset time filter: any, day, week, month, year, or custom | - |
| date_from | string | いいえ | Custom start date in YYYY-MM-DD; requires date_to | - |
| date_to | string | いいえ | Custom end date in YYYY-MM-DD; requires date_from | - |
JSON例
この例は稼働中のエンドポイントカタログからレンダリングされるため、ページは常にDocsおよびPlaygroundと同期しています。
{
"code": 200,
"msg": "OK",
"data": {
"results": [
{
"position": 1,
"title": "OpenAI",
"url": "https://openai.com/",
"description": "OpenAI helps you build and deploy AI systems.",
"hostname": "openai.com",
"path": "research > overview"
}
],
"pagination": {
"offset": 0,
"next_offset": 1
},
"related_queries": [
"openai api"
],
"knowledge_card": {
"title": "OpenAI",
"description": "AI research and deployment company",
"long_description": "OpenAI is an AI research and deployment company building useful models and tools.",
"url": "https://openai.com/",
"image": "https://imgs.search.brave.com/openai-card.png",
"category": "Artificial intelligence company"
},
"discussions": [
{
"position": 1,
"title": "Why is OpenAI so popular?",
"url": "https://www.reddit.com/r/OpenAI/comments/abc123/why_is_openai_so_popular/",
"description": "Trying to understand why OpenAI has such a large audience.",
"forum": "r/OpenAI",
"hostname": "www.reddit.com"
}
],
"videos": [
{
"position": 1,
"title": "OpenAI DevDay keynote - YouTube",
"url": "https://www.youtube.com/watch?v=openai-devday",
"description": "Watch the OpenAI DevDay keynote and product announcements.",
"platform": "YouTube",
"creator": "OpenAI"
}
]
}
}エンドポイントカタログ
/brave/searchReturns normalized web search results from Brave Search for a query string, along with offset-based pagination, related queries, discussions, videos, and the right-side knowledge card when Brave includes one. Use time_range for preset ranges or date_from/date_to for a custom YYYY-MM-DD range. Locale defaults to country=us and lang=en-us.
MCPツール brave_search
/brave/newsReturns normalized Brave news search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search news HTML and return 503 when Brave serves a challenge page or unusable HTML.
レスポンスに関する注記
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI announces update", "url": "https://example.com/openai-news", "description": "OpenAI announced an update.", "source": "Example News", "hostname": "example.com", "thumbnail": "https://imgs.search.brave.com/example-thumb.jpg", "age": "2 hours ago" } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
MCPツール brave_news
/brave/videosReturns normalized Brave video search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search video HTML and return 503 when Brave serves a challenge page or unusable HTML.
レスポンスに関する注記
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI DevDay keynote - YouTube", "url": "https://www.youtube.com/watch?v=openai-devday", "description": "Watch the OpenAI DevDay keynote.", "platform": "YouTube", "creator": "OpenAI", "thumbnail": "https://imgs.search.brave.com/example-thumb.jpg", "duration": "45:12", "age": "November 6, 2023" } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
MCPツール brave_videos
/brave/imagesReturns normalized Brave image search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search image HTML and return 503 when Brave serves a challenge page or unusable HTML.
レスポンスに関する注記
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI colors mobile 08", "url": "https://area17.com/clients/openai", "source": "area17.com", "image_url": "https://media-cdn-prod.area17.com/openai.jpg", "thumbnail": "https://imgs.search.brave.com/example", "width": 1000, "height": 1184 } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
MCPツール brave_images
/brave/suggestReturns Brave autosuggest query completions for a query prefix. Locale defaults to country=us and lang=en-us. Suggestions are fetched from public Brave Search suggest JSON and trimmed to the requested count.
レスポンスに関する注記
- Malformed suggest payloads and upstream blocks return `503`. - Duplicate or empty suggestions are removed from the normalized response. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "openai", "suggestions": [ { "position": 1, "query": "openai api" } ] } } ```
MCPツール brave_suggest
マネージド実行
Crawloraは、対応する公開Brave Search結果ページを、エンドポイント別のリクエストロジック、ドキュメント、Playgroundのサンプル、構造化されたエラーレスポンスとともに正規化JSONに変換します。
Braveのウェブ、ニュース、動画、画像、サジェストページ向けのエンドポイント別リクエストロジック
対応範囲でのプロキシ対応の収集と確認ページ対応処理
オーガニック結果、関連検索キーワード、ディスカッション、動画、ナレッジカードに対する正規化JSON
DocsとPlaygroundのサンプルは稼働中のカタログから生成
対応外または利用不能な上流レスポンスに対する構造化されたエラーレスポンス
ドキュメント化されたエンドポイントコストに基づくクレジット課金
CrawloraはBrave公式のSearch APIではありません。Crawloraは、対応するBrave Search結果ページ向けの構造化Web公開データ抽出エンドポイントを提供します。Brave公式の認可を受けた検索インデックスAPIが必要なユースケースには、Brave公式APIをご利用ください。複数の公開Webデータソースにまたがるドキュメント、Playground、レスポンス正規化、マネージド実行ワークフローを備えたCrawloraのプラットフォーム横断スクレイピングAPIが必要な場合に、Crawloraは有用です。
関連API
このエンドポイントを、関連するCrawloraの検索、モニタリング、ドキュメント、料金の各ページと組み合わせて活用できます。
BraveとBingのSERPデータの露出を比較できます。
開くBraveの結果をGoogle Searchのモニタリングと組み合わせられます。
開くBraveの検索モニタリングに検索需要とトレンド発見のシグナルを追加できます。
開くキーワード順位、結果の変化、検索露出を追跡できます。
開くキーワード・URL・競合モニタリング用の定期SERPチェックを保存できます。
開くBrave Searchを代替エンジンのシグナルとして、キーワード追跡ダッシュボードを構築できます。
開く構造化された結果のスナップショットでキーワード順位と順位URLを確認できます。
開く代理店やSaaSのSEOレポートの背後でCrawloraをデータレイヤーとして利用できます。
開くプラン、クレジット、上限、利用オプションを確認できます。
開く稼働中の全エンドポイントカタログを閲覧できます。
開くBraveのスクレイピング方法
CrawloraのBraveエンドポイントは、qおよびoffset、count、country、langのパラメータを受け付けるGETリクエストです。/brave/searchはoffsetベースでページ分割されたウェブ結果、関連検索キーワード、ディスカッション、動画、そしてBraveが提供する場合は右側のナレッジカードを返します。/brave/news、/brave/videos、/brave/imagesはBraveが対応する範囲でtime_rangeとdateフィルター付きのバーティカル結果を返し、/brave/suggestはオートコンプリート候補を返します。地域パラメータのデフォルトはcountry=us、lang=en-usで、Braveの確認ページに遭遇した場合はドキュメント化された503エラーを返します。
GET /brave/search?q=<keyword>&country=us&lang=en-usにリクエストを送ります。結果行にはposition、title、URL、snippetが含まれ、レスポンスには関連検索キーワード、ディスカッション、動画、存在する場合はナレッジカードも含まれます。
Braveはページ番号ではなくoffsetでページ分割します。offset=<n>を渡せばn番目の結果から続けて読み取れます。複数回の実行間で比較できるよう、各結果とともにoffsetを保存してください。
GET /brave/newsと/brave/videosはtime_rangeとdate_from(ウェブ検索はdate_toにも対応)を受け付け、結果を時間範囲で絞り込めます。これは1回限りのクエリよりモニタリング用途に適しています。GET /brave/imagesは画像結果を返し、/brave/suggestは補完候補を返します。
Braveは独自の独立したインデックスを運用しているため、/brave/searchをCrawloraの/google/searchと/bing/searchエンドポイントと比較すれば、ある順位がGoogle固有のものかどうかを確認できます。同じキー、同じレスポンス構造です。
FAQ
対応する公開検索結果ページ向けにCrawloraを評価している開発者向けの回答です。
はい。Crawloraは対応する公開Brave Search結果ページ向けのエンドポイントを提供し、ドキュメント化されたAPIルート経由で正規化JSONを返します。
いいえ。CrawloraはBrave公式のSearch APIではありません。Crawloraは、対応するBrave Search結果ページ向けの構造化Web公開データ抽出エンドポイントを提供します。Brave公式の認可を受けた検索インデックスAPIが必要なユースケースには、Brave公式APIをご利用ください。
Braveは2026年2月にBrave Search APIの無料プランを廃止し、開発者は従量課金(1000リクエストあたり約5米ドル、月間の少額無料枠は帰属表示が必要)に移行しました。Brave公式APIは現在も存在しますが、CrawloraのBrave Searchエンドポイントは代替手段であり、Crawloraのクレジットベース課金の下でBraveの結果を正規化JSONとして返します。すでにCrawloraでGoogleとBingの検索を利用しており、エンジン横断で同じAPIを使いたい場合に便利です。
Brave公式APIは、Brave Search APIコンソール専用のキーを使用します。Crawloraを使う場合、Braveエンドポイントの呼び出しに必要なのはCrawlora APIキー(x-api-keyヘッダーで送信)1つだけで、同じキーがGoogle・Bing・Brave間で共通して使えます。
カタログの例には、順位、タイトル、URL、説明、ドメイン、ページネーション情報を含むオーガニック結果に加え、Braveが含める場合の関連検索キーワード、ナレッジカードデータ、ディスカッション、動画が含まれます。
はい。特にBraveの露出をGoogleやBingの結果と比較する際に、Brave Searchのデータは SERPモニタリングと検索データ拡充のワークフローを支えます。
対応しています。Braveプラットフォームには検索、ニュース、動画、画像、サジェストの各エンドポイントが含まれ、実際に稼働しているものは生成されたカタログに準拠します。
Crawloraは利用不能な上流レスポンスに対しドキュメント化されたエラーを提供します。対応範囲内では、Braveのメディアエンドポイントのドキュメントは、確認ページ、ブロック、破損したブートストラップデータ、パーサーのずれを503のケースとして記載しています。
Braveは異なるランキングパターン、ディスカッション内容、情報源の多様性、ナレッジカードの背景情報を示すことがあり、追加の検索露出シグナルとして機能します。
BraveにはGoogle Search Consoleのようなサードパーティ向けコンソールはありませんが、Crawloraを使って独自のBrave検索ダッシュボードを構築できます。定期的に構造化されたBrave Search結果を取得し、順位・URL・スニペットを保存すれば、時間経過であなたのドメインと競合のBrave上の順位をモニタリングできます。参考ワークフローについてはSERPモニタリングのユースケースをご覧ください。
Crawloraの/brave/searchエンドポイントにqおよび任意でoffset、country、lang、time_range、date_from、date_toを付けてGETリクエストを送ります。順位、関連検索キーワード、ディスカッション、動画、ナレッジカード付きのウェブ結果をJSONで取得できます。
ページ番号ではなくoffsetによります。offsetを渡せば指定した結果インデックスから続けて読み取れ、レスポンスには使用されたoffsetが記載されるため、複数回の呼び出しを連結できます。
Braveは独自のプランとクォータを持つ公式Search APIを販売しています。Crawloraのエンドポイントは公開の結果ページを読み取り、Google・Bing・DuckDuckGoの各エンドポイントと同じ構造でデータを返します。エンジンごとに個別のベンダーを使うのではなく、エンジン横断で1つの統合を使いたい場合に重要です。
できます。Crawloraの/brave/newsエンドポイントはtime_rangeとdate_fromを受け付け、/brave/searchはdate_fromとdate_toを受け付けるため、結果を時間範囲で限定できます。
Guides
Read Crawlora guides and comparisons that use the Brave API.
Playgroundで/brave/searchをテストし、Docsで現在のレスポンススキーマを確認し、料金ページでクレジット利用量を比較できます。