画像検索

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/images/search?q=mountain+landscape" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

パラメータ付き

curl -s "https://api.search.brave.com/res/v1/images/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=northern lights photography" \
  --data-urlencode "country=US" \
  --data-urlencode "search_lang=en" \
  --data-urlencode "count=20" \
  --data-urlencode "safesearch=strict"

エンドポイント

GET https://api.search.brave.com/res/v1/images/search

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

パラメータ

パラメータ	型	必須	デフォルト	説明
q	string	はい	-	検索クエリ (1-400 文字、最大 50 単語)
country	string	いいえ	US	検索対象国 (2 文字の国コードまたは ALL)
search_lang	string	いいえ	en	2 文字以上の言語コード
count	int	いいえ	50	返すリザルト数 (1-200)
safesearch	string	いいえ	strict	off または strict (画像では moderate はサポートされていません)
spellcheck	bool	いいえ	true	クエリの自動修正; 修正されたクエリは query.altered に含まれます

レスポンス形式

{
  "type": "images",
  "query": {
    "original": "mountain landscape",
    "altered": null,
    "spellcheck_off": false,
    "show_strict_warning": false
  },
  "results": [
    {
      "type": "image_result",
      "title": "Beautiful Mountain Landscape",
      "url": "https://example.com/mountain-photo",
      "source": "example.com",
      "page_fetched": "2025-09-15T10:30:00Z",
      "thumbnail": {
        "src": "https://imgs.search.brave.com/...",
        "width": 200,
        "height": 150
      },
      "properties": {
        "url": "https://example.com/images/mountain.jpg",
        "placeholder": "https://imgs.search.brave.com/placeholder/...",
        "width": 1920,
        "height": 1080
      },
      "meta_url": {
        "scheme": "https",
        "netloc": "example.com",
        "hostname": "example.com",
        "favicon": "https://imgs.search.brave.com/favicon/...",
        "path": "/mountain-photo"
      },
      "confidence": "high"
    }
  ],
  "extra": {
    "might_be_offensive": false
  }
}

レスポンスフィールド

フィールド	型	説明
type	string	常に "images"
query.original	string	オリジナルクエリ
query.altered	string?	スペルチェック済みクエリ (修正がない場合は null)
query.spellcheck_off	bool?	スペルチェックが無効化されたかどうか
query.show_strict_warning	bool?	厳密な安全検索が関連リザルトを非表示にした場合は true
results[]	array	画像リザルトのリスト
results[].type	string	常に "image_result"
results[].title	string?	画像のタイトル
results[].url	string?	画像が見つかったページの URL
results[].source	string?	ソースドメイン
results[].page_fetched	string?	最後のページクロール時刻 (ISO 形式)
results[].thumbnail.src	string?	Brave プロキシ経由のサムネイル URL (約 500px 幅)
results[].thumbnail.width	int?	サムネイル幅
results[].thumbnail.height	int?	サムネイル高さ
results[].properties.url	string?	オリジナルのフルサイズ画像 URL
results[].properties.placeholder	string?	低解像度プレースホルダー URL (Brave プロキシ経由)
results[].properties.width	int?	オリジナル画像の幅 (null の場合もあります)
results[].properties.height	int?	オリジナル画像の高さ (null の場合もあります)
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[].confidence	string?	関連性: low、medium、または high
extra.might_be_offensive	bool	リザルトが不快な内容を含む可能性があるかどうか

ユースケース

• ビジュアルコンテンツの発見: 画像ギャラリー、ムードボード、またはビジュアル調査ツールを構築します。包括的なカバレッジのために count=200 を使用してください。画像固有のメタデータ (寸法、サムネイル) が必要な場合は web-search よりも優先してください。
• コンテンツの充実: 記事や生成されたコンテンツに関連画像を追加します。対象ユーザーのロケールをターゲットにするために country と search_lang を使用してください。
• 安全な画像取得: デフォルトの safesearch=strict は、すぐに家族向けのリザルトを保証します。web/video/news 検索とは異なり、2 つのモード (off/strict) のみであり、moderate オプションはありません。
• 大量バッチ取得: リクエストあたり最大 200 画像 (web は 20、video/news は 50)。一括画像ソーシングまたはビジュアル分析パイプラインに最適です。

注釈

• SafeSearch: 画像のデフォルトは strict (web 検索よりも厳密)
• 大量返却: リクエストあたり最大 200 リザルトを返すことができます
• サムネイル: ユーザープライバシーのため Brave プロキシ経由 (500px 幅)。元の高解像度画像には properties.url を使用してください。
• 寸法: 一部の画像では properties.width/height が欠落する場合があります
• プレースホルダー: properties.placeholder は低解像度 URL (インライン base64 ではない) で、プログレッシブロード UX に有用です