---
title: "Scrape Images"
method: GET
path: "/web/scrape/images"
tags: ["Web Scraping"]
---

# Scrape Images

`GET /web/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.

## Query parameters

- `url` string, uri, required
- `maxAgeMs` integer
- `enrichment` object
  - `resolution` boolean — Measure image width and height when possible.
  - `hostedUrl` boolean — Host materializable images on the Brand.dev CDN and return their URL and MIME type.
  - `classification` boolean — Classify each image by visual asset type.
  - `maxTimePerMs` integer — Per-image enrichment timeout in milliseconds. Default: 30000. Maximum: 60000.
- `dedupe` boolean
- `waitForMs` integer
- `headers` HeaderMap
- `timeoutMS` integer — 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 `200`

Successful response

- object
  - `success` true, required — Always true on success.
  - `images` object[], required — Images found on the page.
    - `src` string, required — Original image value: URL, inline SVG or HTML, or base64 data URI.
    - `element` 'img' | 'svg' | 'link' | 'source' | 'video' | 'css' | 'object' | 'meta' | 'background', required — Where the image was found.
    - `type` 'url' | 'html' | 'base64', required — Format of src.
    - `alt` string, nullable, required — Image alt text, or null when unavailable.
    - `enrichment` object — Requested metadata for images that could be processed.
      - `width` integer — Image width in pixels, when measured.
      - `height` integer — Image height in pixels, when measured.
      - `mimetype` string — Detected MIME type, when hosted.
      - `url` string, uri — Brand.dev CDN URL, when hosted.
      - `type` 'photography' | 'illustration' | 'logo' | 'wordmark' | 'icon' | 'pattern' | 'graphic' | 'other' — Visual asset category, when classified.
  - `url` string, required — Page URL that was scraped.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `400` — Invalid URL or scrape failed.
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or usage limit exceeded
- `408` — Request timeout
- `429` — Rate limit exceeded
- `500` — Internal server error

## Changes

- **2026-07-09** `de91b92d5fb7` — 1 info
  - added the new optional `query` request parameter `dedupe`

[Change history](https://skmtc.dev/context/apis/context-dev/changes/web/scrape/images/get.md)

---

[API](https://skmtc.dev/context/apis/context-dev.md) · [All operations](https://skmtc.dev/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/context-dev/revisions/de91b92d5fb7/schema)