Web Scraping

Scrape Images

Extract image assets from a web page, including standard URLs, inline SVGs, data URIs, responsive image sources, metadata, CSS backgrounds, video posters, and embeds. The base request costs 1 credit. When enrichment is enabled, the entire call costs 5 credits.

get/web/scrape/images

Query parameters

urlstring uri required

Page URL to inspect. Must include http:// or https://.

maxAgeMsinteger

Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1 day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).

resolutionboolean

Measure image width and height when possible.

hostedUrlboolean

Host materializable images on the Brand.dev CDN and return their URL and MIME type.

classificationboolean

Classify each image by visual asset type.

maxTimePerMsinteger

Per-image enrichment timeout in milliseconds. Default: 30000. Maximum: 60000.

Optional per-image processing, sent as deep-object query params such as enrichment[resolution]=true.

dedupeboolean

When true, visually duplicate images are removed: every image is loaded and perceptually hashed, and only the highest-resolution copy of each duplicate group is kept. Images that cannot be downloaded or hashed are kept. Default: false.

waitForMsinteger

Optional browser wait time in milliseconds after initial page load before collecting images. Min: 0. Max: 30000 (30 seconds).

headersHeaderMap

Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.

timeoutMSinteger

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

Response

Successful response

successtrue required

Always true on success.

urlstring required

Page URL that was scraped.

Changes