---
name: batch-url-screenshots
description: Renders a list of web pages in a real browser and returns the images as a zip. Use when a user supplies URLs or domains and wants screenshots, page captures, visual archives or competitor snapshots.
compatibility: Requires HTTPS access to the url2image MCP server or HTTP API.
metadata:
  author: BuiltWith
  version: "1.0.0"
---

# url2image batch screenshots

Prefer the MCP server at `/mcp`.

1. Call `create_screenshot_batch` with the URLs and any render options
   (`format`, `full_page`, `width`, `height`, `dark_mode`).
2. Poll `get_screenshot_batch` with the returned id until `status` is
   `complete`, or until `credits_needed` is above zero.
3. If `credits_needed` is above zero the batch has used up the free monthly
   allowance. Ask the user before calling `create_credit_checkout`, then hand
   them the hosted Stripe URL. Never ask a user for card details and never
   collect them yourself.
4. When the batch is complete, download the artifact from `download_url`.

An agent that holds a stablecoin wallet can skip Stripe entirely and pay per
screenshot over x402: call any priced endpoint, read the HTTP 402 body, and
retry with an `X-PAYMENT` header. The x402 terms are published at
`/.well-known/x402`.

Limits: 500 URLs per batch, 2 MB per uploaded list, 14 day retention on
results. Only public HTTP and HTTPS addresses are rendered; private and
loopback addresses are refused.