---
title: "View public images"
method: POST
path: "/webResearch/view-image"
tags: ["Web research"]
---

# View public images

`POST /webResearch/view-image`

## Request

- Base URL: `https://api.cactal.ai/v1`
- URL: `https://api.cactal.ai/v1/webResearch/view-image`
- Auth: HTTP bearer

Fetches 1 to 48 public image URLs and returns the pictures; nothing is stored. Up to 4 come back full size (an SVG also returns the start of its source); more come back on contact sheets, each a grid of pictures, each under its number (`n`; numbers run on across calls), with a gray checkerboard where a picture is transparent. Import the good ones with `websiteAssets.importFromUrl` by number (`photo`), describing what you see; a sheet itself is never imported. MCP clients that render images get the pictures as images; others get base64 WebP in `pictures`. Not billed to credits.

## Request body

- object
  - `websiteId` string, required: A website you can edit; its organization pays for the call in AI credits.
  - `urls` string[], required: Absolute public image URLs to look at: up to 4 come back full size, more come back on numbered contact sheets.

## Response `200`

The pictures, with what was seen and what failed.

- object
  - `message` string
  - `images` object[], required
    - `n` integer: The number over the picture on the contact sheets; import it by this number (`photo`).
    - `url` string, required
    - `contentType` string
    - `byteSize` integer
    - `width` number, nullable, required
    - `height` number, nullable, required
    - `source` string: The start of an SVG image, as text.
  - `errors` object[], required
    - `n` integer
    - `url` string, required
    - `type` string, required
    - `message` string, required
  - `pictures` object[], required: Base64 WebP: each image full size for up to 4 URLs, otherwise the numbered contact sheets.
    - `data` string, required
    - `mediaType` string, required
    - `filename` string, required

## Other responses

- `400`: Validation failed. The response `message` names the first invalid field.
- `401`: Missing, invalid, expired, or revoked API key.
- `403`: The authenticated principal lacks the required capability.
- `404`: The resource does not exist or is outside the principal’s access scope.
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` header.

---

[API](https://skmtc.dev/cactal/apis/cactal-api.md) · [All operations](https://skmtc.dev/cactal/apis/cactal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cactal/apis/cactal-api/revisions/9cd0fb5eacdd?raw)