Capture screenshots of any URL, HTML, or Markdown as PNG, JPEG, WebP, or PDF via pay-per-call MPP.
What it does
ScreenshotOne via Locus MPP is a website screenshot API accessible through the Merchant Payment Protocol (MPP). It renders any URL, raw HTML, or Markdown content into image or PDF output. The endpoint supports multiple output formats (PNG, JPEG, WebP, GIF, PDF), full-page capture, element-level selection via CSS selectors, configurable viewports, dark mode, ad blocking, and cookie banner suppression.
The API is invoked via POST with a JSON body specifying the source (url, html, or markdown) and rendering options. Payment is settled per-call on Tempo L2 using pathUSD at $0.055 per screenshot (55000 base units, 6 decimals). The response can return the rendered image directly (by_format), as a JSON wrapper, or empty (useful if you only need side effects like storage).
Note: The endpoint is routed exclusively to POST requests. HEAD and GET probes return 404, which is expected behavior for a POST-only resource. The OpenAPI spec is well-defined with full request schema and payment metadata. External documentation is available at screenshotone.com.
Capabilities
Use cases
- —Generating social media preview images (OG images) from web pages
- —Automated visual regression testing by capturing page screenshots
- —Creating PDF exports of rendered HTML or Markdown documents
- —Building link preview thumbnails for chat or CMS applications
- —Monitoring website appearance changes over time
Fit
Best for
- —Agents that need on-demand visual captures of arbitrary URLs
- —Workflows requiring rendered HTML/Markdown to image conversion
- —Applications needing ad-free, cookie-banner-free page captures
- —Developers wanting pay-per-use screenshot generation without API key management
Not for
- —High-volume batch screenshot jobs where per-call pricing is prohibitive
- —Real-time video or animation capture beyond single-frame GIF
- —Scraping structured text data from web pages (use a scraping API instead)
Quick start
curl -X POST https://screenshotone.mpp.paywithlocus.com/screenshotone/take \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <MPP_TOKEN>" \
-d '{"url": "https://example.com", "format": "png", "full_page": true}'Example
Request
{
"url": "https://example.com",
"format": "png",
"block_ads": true,
"dark_mode": false,
"full_page": true,
"response_type": "by_format",
"viewport_width": 1280,
"viewport_height": 1024,
"device_scale_factor": 2,
"block_cookie_banners": true
}Endpoint
Quality
Full OpenAPI schema with detailed request parameters and payment metadata is available. The endpoint is POST-only (404 on HEAD/GET is expected). No example response body is documented, and crawl pages only return generic 404 JSON from the gateway. Pricing and capabilities are clear from the spec.
Warnings
- —Endpoint returns 404 on HEAD/GET probes; it is POST-only — not necessarily down
- —No example response documented; response_type 'by_format' returns raw binary image data
- —Currency address 0x20c0... assumed to be pathUSD (6 decimals) based on Tempo L2 convention; if different, price calculation may be incorrect
Citations
- —OpenAPI spec describes the endpoint as a website screenshot API supporting PNG, JPEG, WebP, GIF, PDF outputhttps://screenshotone.mpp.paywithlocus.com
- —Payment amount is 55000 base units settled via Tempo method with intent 'charge'https://screenshotone.mpp.paywithlocus.com
- —External API reference documentation available at screenshotone.comhttps://screenshotone.com/docs/getting-started/ScreenshotOne