---
title: "Extracts image data from a specified URL using Puppeteer."
method: POST
path: "/extractImagesFromURL"
---

# Extracts image data from a specified URL using Puppeteer.

`POST /extractImagesFromURL`

The extractImagesFromURL function is a convenience wrapper that opens a URL, extracts images, and closes the browser. It's designed for single-use scraping tasks, returning detailed information about images found on the webpage. This function utilizes Puppeteer to render the page and extract image data including src, srcset, responsive images, and alt text.

## Request body

- object
  - `body` object — Body of the extractImagesFromURL sls call
    - `arguments` object, required — Configuration object containing all function parameters.
      - `url` string, required — The URL of the webpage to extract images from.
      - `isLocal` boolean — Indicates whether the URL is a local file or a remote web address.
      - `headless` boolean — Determines whether to run the browser in headless mode.
      - `waitUntil` 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2' — Defines when to consider navigation successful.

## Response `200`

Successful response with extracted image data

- object[]
  - `src` string, nullable — The source URL of the image
  - `srcset` string, nullable — The srcset attribute of the image
  - `responsiveImages` object[], nullable — Array of responsive image objects
    - `url` string — URL of the responsive image
    - `size` string — Size descriptor of the responsive image
  - `alt` string, nullable — The alt text of the image

## Other responses

- `400` — Bad request - invalid input parameters
- `404` — Not found - the specified URL could not be accessed
- `500` — Internal server error

## Changes

- **2025-07-11** `bec7ca269ff6` — 1 warning
  - removed the request property `body/arguments/deepExtract`
- **2025-07-11** `77a95d92ed90` — 2 info
  - added the new optional request property `body/arguments/deepExtract`
  - added the new optional request property `body/arguments/waitUntil`
- **2025-07-10** `d193868de840` — 1 warning
  - removed the request property `body/arguments/waitUntil`

[Change history](https://skmtc.dev/microfox-ai/apis/chrome-browser-use/changes/extractImagesFromURL/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/chrome-browser-use.md) · [All operations](https://skmtc.dev/microfox-ai/apis/chrome-browser-use/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/chrome-browser-use/revisions/b9d32be518ee/schema)