Images Search

作者 brave62793e0c49ed无许可证183 个星标收录于 2026年10月8日更新于 2026年10月8日仓库2周前更新

USE FOR image search. Returns images with title, source URL, thumbnail. Supports SafeSearch filter. Up to 200 results.

仅含说明Research & Analysis

AI 生成的概览

调用 Brave 图片搜索 API，返回包含标题、来源网址、缩略图和元数据的图片结果。

功能: 该技能说明如何调用 Brave 图片搜索 API 端点来执行图片搜索。内容涵盖必需的 API 密钥请求头、查询参数（如国家、语言、结果数量和 SafeSearch），以及 JSON 响应格式。它还说明返回字段，包括标题、页面网址、来源域名、缩略图、原始图片尺寸和相关性置信度，并列出视觉内容发现、批量图片获取等使用场景。
适用场景: 当你需要按查询查找图片，并希望获得包含缩略图、来源页面和图片尺寸的结构化结果时使用。它适用于视觉调研、图库或情绪板搭建、内容配图以及批量图片采集。需要 SafeSearch 过滤或按地区定向时也适用。
运行要求: 需要 Brave Search API 密钥，通过 X-Subscription-Token 请求头发送，并需要访问 api.search.brave.com 的网络连接。需要包含 Search 计划的订阅方案。该技能仅包含说明，不附带脚本。

Images Search

Requires API Key: Get one at https://api.search.brave.com

Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Quick Start (cURL)

Basic Search

bash

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

With Parameters

bash

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"

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"

Endpoint

Authentication: X-Subscription-Token: <API_KEY> header

Parameters

Parameter	Type	Required	Default	Description
`q`	string	Yes	-	Search query (1-400 chars, max 50 words)
`country`	string	No	`US`	Search country (2-letter country code or `ALL`)
`search_lang`	string	No	`en`	2+ char language code
`count`	int	No	50	Results to return (1-200)
`safesearch`	string	No	`strict`	`off` or `strict` (no `moderate` for images)
`spellcheck`	bool	No	true	Auto-correct query; corrected query in `query.altered`

Response Format

json

{  "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": "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  }}

Response Fields

Field	Type	Description
`type`	string	Always `"images"`
`query.original`	string	Original query
`query.altered`	string?	Spellchecked query (null if no correction)
`query.spellcheck_off`	bool?	Whether spellcheck was disabled
`query.show_strict_warning`	bool?	True if strict safesearch hid relevant results
`results[]`	array	List of image results
`results[].type`	string	Always `"image_result"`
`results[].title`	string?	Image title
`results[].url`	string?	Page URL where image was found
`results[].source`	string?	Source domain
`results[].page_fetched`	string?	ISO datetime of last page crawl
`results[].thumbnail.src`	string?	Brave-proxied thumbnail URL (~500px width)
`results[].thumbnail.width`	int?	Thumbnail width
`results[].thumbnail.height`	int?	Thumbnail height
`results[].properties.url`	string?	Original full-size image URL
`results[].properties.placeholder`	string?	Low-res placeholder URL (Brave-proxied)
`results[].properties.width`	int?	Original image width (may be null)
`results[].properties.height`	int?	Original image height (may be null)
`results[].meta_url.scheme`	string?	URL protocol scheme
`results[].meta_url.netloc`	string?	Network location
`results[].meta_url.hostname`	string?	Lowercased domain
`results[].meta_url.favicon`	string?	Favicon URL
`results[].meta_url.path`	string?	URL path
`results[].confidence`	string?	Relevance: `low`, `medium`, or `high`
`extra.might_be_offensive`	bool	Whether results may contain offensive content

Use Cases

Visual content discovery: Build image galleries, mood boards, or visual research tools. Use count=200 for comprehensive coverage. Prefer over web-search when you need image-specific metadata (dimensions, thumbnails).
Content enrichment: Add relevant images to articles or generated content. Use country and search_lang to target your audience's locale.
Safe image retrieval: Default safesearch=strict ensures family-friendly results out of the box. Only two modes (off/strict) — no moderate option, unlike web/video/news search.
High-volume batch retrieval: Up to 200 images per request (vs 20 for web, 50 for videos/news). Ideal for bulk image sourcing or visual analysis pipelines.

Notes

SafeSearch: Defaults to strict for images (stricter than web search)
High volume: Can return up to 200 results per request
Thumbnails: Brave-proxied for user privacy (500px width). Use properties.url for original full-resolution image.
Dimensions: properties.width/height may be missing for some images
Placeholder: properties.placeholder is a low-res URL (not inline base64) useful for progressive loading UX

来源与署名

来源：brave/brave-search-skills位于skills/images-search提交62793e0

许可证：无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

Images Search

Images Search

Quick Start (cURL)

Basic Search

With Parameters

Endpoint

Parameters

Response Format

Response Fields

Use Cases

Notes

来源与署名

更多来自 brave/brave-search-skills 的技能

Web Search

Suggest

Videos Search

Spellcheck

Local Pois

News Search

更多Research & Analysis技能

Equity Research

Sector Overview

Idea Generation

Competitive Analysis

Notion Research Documentation

Notion Meeting Intelligence