AGENTUTIL
DocsTools Reference

Browser Screenshot

$0.01per call
browser.screenshot

Capture a screenshot of a webpage or HTML content

Endpoint
POST /v1/tools/browser.screenshot/tasks

Input

FieldTypeRequiredDescription
urlstringnoURL to capture
htmlstringnoHTML content to render
widthintegernoViewport width
heightintegernoViewport height
full_pagebooleannoCapture full scrollable page
formatstringno
qualityintegernoQuality for jpeg/webp (1-100)
transparentbooleannoTransparent background (png only)
waitstringnoWhen to capture

Output

FieldTypeDescription
file_idstringStored artifact ID
file_urlstring24-hour signed URL for the rendered image
content_typestringArtifact MIME type
file_url_notesstringNotes about the signed URL lifetime
expires_atstringSigned URL expiry timestamp
expires_in_daysintegerSigned URL expiry in days
widthinteger
heightinteger
bytesinteger

Example

Request
{
  "url": "https://example.com",
  "width": 1280,
  "full_page": true
}
Response
{
  "file_id": "file_abc123def4567890",
  "file_url": "https://1234567890abcdef.r2.cloudflarestorage.com/agentutil/browser/123/screenshot-file_abc123def4567890.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=86400&X-Amz-Signature=...",
  "content_type": "image/png",
  "file_url_notes": "Signed URL will expire in 24 hours. If you need it for longer then download it and store it somewhere",
  "expires_at": "2026-03-12T08:00:00.000Z",
  "expires_in_days": 1,
  "width": 1280,
  "height": 2400,
  "bytes": 145832
}