ニュース検索

API キーが必要です: https://api.search.brave.com で取得してください

プラン: Search プランに含まれています。https://api-dashboard.search.brave.com/app/subscriptions/subscribe を参照してください

クイックスタート (cURL)

基本的な検索

curl -s "https://api.search.brave.com/res/v1/news/search?q=space+exploration" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

最近のニュース (過去24時間)

curl -s "https://api.search.brave.com/res/v1/news/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=cybersecurity" \
  --data-urlencode "country=US" \
  --data-urlencode "freshness=pd" \
  --data-urlencode "count=20"

日付範囲フィルター

curl -s "https://api.search.brave.com/res/v1/news/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=climate summit" \
  --data-urlencode "freshness=2026-01-01to2026-01-31"

エンドポイント

GET https://api.search.brave.com/res/v1/news/search
POST https://api.search.brave.com/res/v1/news/search

認証: X-Subscription-Token: <API_KEY> ヘッダー

注: GET と POST の両方がサポートされています。長いクエリまたは複雑な Goggles に対しては POST が便利です。

パラメーター

パラメーター	型	必須	デフォルト	説明
q	string	はい	-	検索クエリ (1-400 文字、最大 50 語)
country	string	いいえ	US	検索対象国 (2 文字の国コードまたは ALL)
search_lang	string	いいえ	en	言語設定 (2 文字以上の言語コード)
ui_lang	string	いいえ	en-US	UI 言語 (例: "en-US")
count	int	いいえ	20	結果の件数 (1-50)
offset	int	いいえ	0	ページオフセット (0-9)
safesearch	string	いいえ	strict	アダルトコンテンツフィルター (off/moderate/strict)
freshness	string	いいえ	-	時間フィルター (pd/pw/pm/py または日付範囲)
spellcheck	bool	いいえ	true	クエリの自動修正
extra_snippets	bool	いいえ	-	結果ごとに最大 5 つの追加抜粋
goggles	string または array	いいえ	-	カスタムランキングフィルター (URL またはインライン; 複数指定の場合はパラメーターを繰り返す)
operators	bool	いいえ	true	検索演算子を適用
include_fetch_metadata	bool	いいえ	false	結果にフェッチタイムスタンプを含める

鮮度値

値	説明
pd	過去 1 日 (24 時間) - 速報ニュースに最適
pw	過去 1 週間 (7 日)
pm	過去 1 ヶ月 (31 日)
py	過去 1 年 (365 日)
YYYY-MM-DDtoYYYY-MM-DD	カスタム日付範囲

レスポンス形式

{
  "type": "news",
  "query": {
    "original": "space exploration"
  },
  "results": [
    {
      "type": "news_result",
      "title": "New Developments in Space Exploration",
      "url": "https://news.example.com/space-exploration",
      "description": "Recent missions have advanced our understanding of...",
      "age": "2 hours ago",
      "page_age": "2026-01-15T14:30:00",
      "page_fetched": "2026-01-15T15:00:00Z",
      "meta_url": {
        "scheme": "https",
        "netloc": "news.example.com",
        "hostname": "news.example.com",
        "favicon": "https://imgs.search.brave.com/favicon/news.example.com",
        "path": "/space-exploration"
      },
      "thumbnail": {
        "src": "https://imgs.search.brave.com/..."
      }
    }
  ]
}

レスポンスフィールド

フィールド	型	説明
type	string	常に "news"
query.original	string	元の検索クエリ
query.altered	string?	スペルチェック修正後のクエリ (変更された場合)
query.cleaned	string?	スペルチェッカーにより正規化されたクエリ
query.spellcheck_off	bool?	スペルチェックが無効化されているかどうか
query.show_strict_warning	bool?	厳密な safesearch により結果がブロックされているかどうか
query.search_operators	object?	適用された検索演算子
query.search_operators.applied	bool	演算子が適用されたかどうか
query.search_operators.cleaned_query	string?	演算子処理後のクエリ
query.search_operators.sites	list[str]?	site: 演算子から抽出されたドメイン
results[].type	string	常に "news_result"
results[].title	string	記事のタイトル
results[].url	string	記事のソース URL
results[].description	string?	記事の説明/概要
results[].age	string?	人間が読みやすい経過時間 (例: "2 hours ago")
results[].page_age	string?	ソースからの公開日 (ISO 形式の日時)
results[].page_fetched	string?	ページが最後にフェッチされた日時 (ISO 形式の日時)
results[].fetched_content_timestamp	int?	フェッチタイムスタンプ (include_fetch_metadata=true の場合のみ)
results[].meta_url.scheme	string?	URL プロトコルスキーム
results[].meta_url.netloc	string?	ネットワークロケーション
results[].meta_url.hostname	string?	小文字に変換されたドメイン名
results[].meta_url.favicon	string?	ファビコン URL
results[].meta_url.path	string?	URL パス
results[].thumbnail.src	string	提供されるサムネイル URL
results[].thumbnail.original	string?	元のサムネイル URL
results[].extra_snippets	list[str]?	結果ごとに最大 5 つの追加抜粋

Goggles (カスタムランキング) — Brave 独自機能

Goggles を使用して、ニュース結果を再度ランク付け - 信頼できるアウトレットを強調したり、不要なソースを抑制したりできます。

方法	例
ホスト型	--data-urlencode "goggles=https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/hacker_news.goggle"
インライン型	--data-urlencode 'goggles=$discard\n$site=example.com'

ホスト型 Goggles は GitHub/GitLab 上に置き、! name:、! description:、! author: ヘッダーを含める必要があり、https://search.brave.com/goggles/create で登録される必要があります。インライン型 ルールは登録の必要はありません。

構文: $boost=N / $downrank=N (1–10)、$discard、$site=example.com。カンマで組み合わせます: $site=example.com,boost=3。ルールを \n (%0A) で区切ります。

ホワイトリスト: $discard\n$site=docs.python.org\n$site=developer.mozilla.org — ブラックリスト: $discard,site=pinterest.com\n$discard,site=quora.com

リソース: Discover · Syntax · Quickstart

検索演算子

検索演算子を使用して結果を絞り込みます:

• site:local-paper.com - 特定のニュースサイトに限定
• "exact phrase" - 完全一致フレーズ
• -exclude - 用語を除外

operators=false で演算子の解析を無効化します。

ユースケース

• 速報監視: freshness=pd を使用して、あるトピックに関する最新の記事を取得します。
• Goggles を使用したカスタムニュースフィード: 信頼できるソースを強調し、他のソースを除外します — Brave 独自の機能です。
• 歴史的なニュース調査: freshness=YYYY-MM-DDtoYYYY-MM-DD を使用して、特定の時期の記事を見つけます。
• 多言語ニュース: country、search_lang、ui_lang を組み合わせて、クロスロケール結果を取得します。
• データパイプライン: include_fetch_metadata=true を設定して、各結果の fetched_content_timestamp を取得します。

注記

• SafeSearch: デフォルトは strict
• ページネーション: count と共に offset (0-9) を使用
• 追加スニペット: extra_snippets=true の場合、結果ごとに最大 5 つの追加抜粋