Pay-per-call screenshot and PDF capture of any URL via x402 ($0.02 USDC on Base).
What it does
Visual API is an x402-enabled endpoint that captures screenshots and PDFs of arbitrary URLs. It runs a headless browser on the server side so callers need no browser infrastructure. Payment is $0.02 USDC per call on the Base network, settled via the x402 protocol.
The `/visual/screenshot` endpoint accepts a target URL and returns a JPEG or PNG image. Callers can customize viewport dimensions (320–3840 × 240–2160), enable full-page scroll capture (up to 32,768 px height), choose JPEG quality (1–100), toggle dark mode, block ads and cookie banners, target a specific CSS selector, or emulate device presets (iphone_15, pixel_7, ipad_pro). The sibling `/visual/pdf` endpoint converts a URL to PDF with optional ad blocking.
The service exposes a full OpenAPI 3.1 spec at `/openapi.json` and a health endpoint that reports browser status, semaphore slots, in-flight requests, cache stats, and uptime. Alternative access methods include an MCP gateway at `mcp.hugen.tokyo`, a free API-key flow (POST to `discovery.hugen.tokyo/keys/create`), and a Python SDK (`pip install x402-pay`). The x402 challenge was captured successfully, confirming the endpoint is live.
Capabilities
Use cases
- —Capturing visual snapshots of web pages for archival or monitoring
- —Generating thumbnail previews of URLs in link-sharing applications
- —Converting web pages to PDF for offline reading or compliance records
- —Automated visual regression testing of websites
- —Providing AI agents with rendered page images for visual analysis
Fit
Best for
- —Agents or apps that need on-demand screenshots without running their own browser
- —Pay-per-use screenshot capture with no subscription or API key required
- —Quick PDF generation from arbitrary URLs
Not for
- —High-volume bulk screenshot pipelines where per-call pricing adds up
- —Capturing pages behind authentication (no cookie/session injection documented)
- —Real-time video or animated content capture
Quick start
pip install x402-pay
import x402_pay
resp = x402_pay.get(
'https://visual.hugen.tokyo/visual/screenshot?url=https://example.com&width=1280&height=720&format=jpeg'
)
with open('screenshot.jpg', 'wb') as f:
f.write(resp.content)Example
Request
{
"url": "https://visual.hugen.tokyo/visual/screenshot",
"method": "GET",
"query_params": {
"url": "https://example.com",
"width": 1280,
"format": "jpeg",
"height": 720,
"quality": 80,
"block_ads": true,
"dark_mode": false,
"full_page": false
}
}Response
{
"format": "jpeg",
"viewport": {
"width": 1280,
"height": 720
},
"page_title": "Example Domain",
"captured_at": "2026-03-05T12:34:56Z",
"image_base64": "<base64-encoded JPEG data>",
"render_time_ms": 1847,
"file_size_bytes": 48320
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed parameter constraints, live x402 402 challenge confirming the endpoint works, clear pricing ($0.02 USDC on Base), and a sample response structure. Docked slightly because crawled docs pages are thin (no prose documentation, no usage examples beyond the challenge), and the response schema is not formally defined in the OpenAPI spec.
Warnings
- —Response schema for /visual/screenshot is empty in the OpenAPI spec; the example response structure is inferred from the x402 challenge payload.
- —No documentation on authentication-based page capture (cookies, sessions).
- —Root URL returns 404; documentation is only at /docs.
Citations
- —Screenshot and PDF capture of any URL — no browser infrastructure needed, no server costs. Pay per capture.https://visual.hugen.tokyo/docs
- —Payment required ($0.02 USDC on Base)https://visual.hugen.tokyo/visual/screenshot
- —Device presets include iphone_15, pixel_7, ipad_prohttps://visual.hugen.tokyo/docs
- —Alternative access via MCP gateway at mcp.hugen.tokyo and Python SDK x402-payhttps://visual.hugen.tokyo/visual/screenshot
- —OpenAPI 3.1 spec available at /openapi.jsonhttps://visual.hugen.tokyo/docs