# MiniFrame Tools Screenshot

> MiniFrame Tools Screenshot is a paid API for AI agents from tools.miniframe.com.br, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Takes a JavaScript-rendered screenshot of a public web page using a headless browser and returns it as a base64-encoded image

## Facts

- Endpoint: POST https://tools.miniframe.com.br/screenshot
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/miniframe-tools-screenshot-efd57401
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n-TQs1Pg3Z96ZCfJULpae

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability miniframe-tools-screenshot-efd57401 -d '<json body>'
```

Example prompt: Grab a full-page PNG screenshot of https://example.com using a 1440px wide viewport so I can see how it looks on a desktop browser.

## When to prefer this

Choose this endpoint when you need a visual screenshot of a web page that requires JavaScript rendering, at a specific viewport size, and want the result as a base64-encoded image. Prefer over static HTML fetchers when the page relies on JS frameworks like React or Vue.

## Known failure modes

- Private or internal IP targets are blocked and will return an error
- Invalid or malformed URLs result in a request error
- Viewport dimensions outside 320–2000 (width) or 240–2000 (height) are rejected
- Pages that fail to load or time out in the headless browser return an error
- Non-public URLs (e.g. localhost, 192.168.x.x) are blocked for security reasons

## How this service works

Use when the user needs to see a page as it actually renders — visual proof, a preview, a layout check, or a record of what a page showed. Takes a screenshot with a headless browser (rendering JavaScript). JSON body { url } (public http/https); optional full_page (default false), width (320–2000, default 1280), height (240–2000, default 800), format png|jpeg (default png). Returns image_base64. Private/internal targets are blocked.

## Output

A JSON response containing image_base64 — a base64-encoded PNG or JPEG image of the rendered web page, captured at the requested viewport dimensions, with JavaScript fully executed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public http/https URL."
  },
  "width": {
   "type": "number",
   "description": "Viewport width 320–2000 (optional)."
  },
  "format": {
   "enum": [
    "png",
    "jpeg"
   ],
   "type": "string",
   "description": "Image format (optional)."
  },
  "height": {
   "type": "number",
   "description": "Viewport height 240–2000 (optional)."
  },
  "full_page": {
   "type": "boolean",
   "description": "Capture full scrollable page (optional)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "width": 1280,
  "format": "png",
  "height": 800,
  "full_page": false,
  "image_base64": "iVBORw0KGgo..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/miniframe-tools-screenshot-efd57401/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.miniframe.com.br](https://www.zero.xyz/host/tools.miniframe.com.br/llms.txt)