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

# Scrape images from a URL

`GET /web/scrape/images`

Scrapes all images from the given URL. Extracts images from img, svg, picture/source, link, and video elements including inline SVGs, base64 data URIs, and standard URLs.

## Query parameters

- `url` string, uri, required

## Response `200`

Successful response

- object
  - `success` true, required — Indicates success
  - `images` object[], required — Array of scraped images
    - `src` string, required — The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
    - `element` 'img' | 'svg' | 'link' | 'source' | 'video' | 'css' | 'object' | 'meta' | 'background', required — The HTML element the image was found in
    - `type` 'url' | 'html' | 'base64', required — The type/format of the src value
    - `alt` string, nullable, required — Alt text of the image, or null if not present
  - `url` string, required — The URL that was scraped

## Other responses

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

## Changes

- **2026-03-26** `5e05c22cc2ee` — 4 warning
  - added the new `background` enum value to the `images/items/element` response property for the response status `200`
  - added the new `css` enum value to the `images/items/element` response property for the response status `200`
  - added the new `meta` enum value to the `images/items/element` response property for the response status `200`
  - added the new `object` enum value to the `images/items/element` response property for the response status `200`
- **2026-02-23** `2cdd67823c6a` — 1 info
  - endpoint added

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

---

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