这项服务的一切功能,都能通过 HTTP 调用。
一个接口提交批次,一个查询状态,一个下载结果。如果你的客户端偏爱类型化工具,这里有 MCP 服务器;如果偏爱 schema,这里有 OpenAPI 描述。
一个密钥绑定一个全新账户,拥有独立的额度和独立的批次。请妥善保管:它是访问该账户的唯一凭证。
| 接口 | 地址 |
|---|---|
| OpenAPI | /openapi.json |
| Markdown 参考文档 | /docs/api |
| MCP 端点 | POST https://url2image.com/mcp |
| MCP 服务器卡片 | /.well-known/mcp/server-card.json |
| Agent card | /.well-known/agent-card.json |
| Agent skill | SKILL.md |
| 鉴权指南 | /auth.md |
| x402 条款 | /.well-known/x402 |
| Stripe 结账 | 可用 |
url2image API
Render a list of URLs in a real browser and get the screenshots back as a zip. A BuiltWith service.
Quick start
curl -X POST https://url2image.com/api/v1/batch \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $URL2IMAGE_KEY" \
-d '{"urls":["https://stripe.com","https://vercel.com"],"format":"png","full_page":true}'
That returns a batch id. Poll it, then download:
curl https://url2image.com/api/v1/jobs/$ID -H "Authorization: Bearer $URL2IMAGE_KEY" curl -L https://url2image.com/api/v1/jobs/$ID/download -H "Authorization: Bearer $URL2IMAGE_KEY" -o screenshots.zip
One URL, one image, no polling:
curl -X POST https://url2image.com/api/v1/shot \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $URL2IMAGE_KEY" \
-d '{"url":"https://stripe.com"}' --output stripe.png
Getting a key
POST https://url2image.com/api/v1/keys returns a key bound to a fresh account. Keep it:
it is the only handle on that account's credits and batches. Browsers do not
need a key, a signed cookie carries the same identity.
Pricing
Every account gets 10 free screenshots a month. The allowance is metered
per network address as well as per account, so issuing a second key does not
reset it. After that, credits are prepaid and never expire.
| Pack | Price | Credits | Per screenshot |
| Starter | $5 | 2,500 | $0.002 |
| Growth | $20 | 15,000 | $0.0013 |
| Scale | $75 | 75,000 | $0.001 |
| Bulk | $250 | 350,000 | $0.000714 |
A URL that fails every attempt is not charged.
Discovery
- OpenAPI: https://url2image.com/openapi.json
- MCP endpoint: https://url2image.com/mcp
- MCP server card: https://url2image.com/.well-known/mcp/server-card.json
- Agent card: https://url2image.com/.well-known/agent-card.json
- Agent skill: https://url2image.com/.well-known/agent-skills/batch-url-screenshots/SKILL.md
- x402 terms: https://url2image.com/.well-known/x402
- Auth guide: https://url2image.com/auth.md
MCP tools
create_screenshot_batch: queue URLs for rendering.get_screenshot_batch: read state and per URL results.get_account_balance: credits and free allowance remaining.create_credit_checkout: hosted Stripe Checkout for a credit pack (available).
Paying as an agent
Two rails, both without card handling here:
1. Hosted Stripe Checkout. The tool returns a URL, a person confirms on
Stripe's page, credits land on the account.
2. x402 (available). Call a priced endpoint, read the 402 body,
retry with an X-PAYMENT header. Terms at https://url2image.com/.well-known/x402.
Limits
- 500 URLs per batch, 2 MB per uploaded list.
- Results and images are deleted after 14 days.
- Only public HTTP and HTTPS hosts are rendered. Private, loopback and
link-local addresses are refused at render time.
Support: support@builtwith.com. Terms: https://builtwith.com/terms.
Privacy: https://builtwith.com/privacy.