images-search

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

By brave · 1,452 installs

npx skills add brave/brave-search-skills --skill images-search

Source repository · Upstream listing

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 With Parameters 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 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