Brave Images Scraper

Scrapes image search results from Brave Search (search.brave.com/images). Extracts the full canonical image-vertical schema: title, alt text, full image URL, thumbnail, dimensions, aspect ratio, file format, dominant color, NSFW flag, source attribution, creator, license, and more.

What this Actor collects

Each dataset item represents one Brave Images result, with the full image, thumbnail, source page, dimensions, format, attribution, safety flags, and search context that Brave exposes.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 60-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Visual research
• Image-source discovery
• Media and asset enrichment

Input

Provide input in JSON. Fields marked required must be supplied; source-specific alternatives and constraints are described in the field text.

Field	Type	Required	Default	Description
query	string	Yes	—	The image search query.
maxItems	integer	No	100	Maximum number of images to scrape.
country	string	No	"us"	Brave country code (e.g. 'us', 'gb', 'in').
language	string	No	"en"	Brave language code (e.g. 'en', 'de', 'fr').
safeSearch	string	No	"moderate"	Safe search filter. Options: "off", "moderate", or "strict".
size	string	No	""	Image-size filter: small, medium, large, wallpaper, or empty for no filter.
color	string	No	""	Color filter: color, bw, a supported named color, or empty for no filter.
type	string	No	""	Image-type filter: photo, clipart, gif, transparent, line, or empty for no filter.
layout	string	No	""	Filter by image layout. Options: "square", "tall", "wide".
license	string	No	""	License filter: creativecommon, commercial, or empty for no filter.
maxScrolls	integer	No	20	Maximum page-bottom scrolls used to load additional image cards.
navigationTimeoutSecs	integer	No	60	Maximum seconds to wait for the search page navigation.
maxRequestRetries	integer	No	3	Retries temporary rate limits and server errors with progressive backoff.
headless	boolean	No	true	Disable only for local visual debugging.
proxyConfiguration	object	No	—	Proxy settings. Residential proxies recommended.

Example input

{
  "query": "nature photography",
  "maxItems": 100,
  "country": "us",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  },
  "safeSearch": "moderate"
}

Output

The default dataset contains one item per image result. The following are the most useful fields; creator, license, dimensions, and safety fields appear only when Brave provides them.

Field	Type	Description
position	integer	Position
title	string	Title
imageUrl	string	Image URL
thumbnailUrl	string	Thumbnail URL
sourceDomain	string	Source Domain
creator	string	Creator
license	string	License
width	integer	Width
height	integer	Height
fileFormat	string	File Format
aspectRatio	number	Aspect Ratio
searchQuery	string	Search Query
country	string	Country
scrapedAt	string	Scraped At
type	string	Record Type
url	string	URL

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "title": "Beautiful Purple, graphy, purple, nature, forests, rivers, HD wallpaper",
  "imageUrl": "https://w0.peakpx.com/wallpaper/204/148/HD-wallpaper-beautiful-purple-graphy-purple-nature-forests-rivers-thumbnail.jpg",
  "thumbnailUrl": "https://imgs.search.brave.com/tlgHd0ijn2f-R2xnKVbtsQAvO4qVoFtAxU0U7S_7U-U/rs:fit:500:0:1:0/g:ce/aHR0cHM6Ly93MC5w/ZWFrcHguY29tL3dh/bGxwYXBlci8yMDQv/MTQ4L0hELXdhbGxw/YXBlci1iZWF1dGl…",
  "sourceDomain": "peakpx.com",
  "width": 338,
  "height": 255,
  "fileFormat": "jpg",
  "aspectRatio": 1.3255,
  "searchQuery": "nature photography",
  "country": "us",
  "scrapedAt": "2026-07-23T15:40:13.852Z"
}

Related Actors

• Brave AI Mode Scraper
• Brave Autocomplete Scraper
• Brave Discussions Scraper