{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://urlpipe.dev/#organization","name":"URLpipe","url":"https://urlpipe.dev","logo":"https://urlpipe.dev/icon.png","sameAs":["https://github.com/URLpipe"],"founder":{"@type":"Person","name":"Roger Campos","url":"https://rogercampos.com"}},{"@type":"WebSite","@id":"https://urlpipe.dev/#website","url":"https://urlpipe.dev","name":"URLpipe","publisher":{"@id":"https://urlpipe.dev/#organization"}}]}{"@context":"https://schema.org","@graph":[{"@type":"TechArticle","@id":"https://urlpipe.dev/code/java/screenshot#article","headline":"Take a website screenshot in Java — working code","description":"Screenshot any website in Java: a full-page PNG from real Chrome, the async variant with a webhook, and retries. Tested code.","url":"https://urlpipe.dev/code/java/screenshot","mainEntityOfPage":"https://urlpipe.dev/code/java/screenshot","datePublished":"2026-09-24","dateModified":"2026-09-24","author":{"@type":"Person","name":"Roger Campos","url":"https://rogercampos.com"},"publisher":{"@id":"https://urlpipe.dev/#organization"},"image":"https://urlpipe.dev/og-image.png"},{"@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Why is the screenshot response Base64 and not an image?","acceptedAnswer":{"@type":"Answer","text":"So the same body works in JSON, in a webhook payload and in an ![]()
data URI. Decode it with Base64.getDecoder(), or skip decoding and use the X-Result-Url header, a direct link to the image."}},{"@type":"Question","name":"How do I take a mobile screenshot?","acceptedAnswer":{"@type":"Answer","text":"Set screenshot_options.viewport_width to a phone width such as 390 and device_scale_factor to 2 or 3. The viewport can be anything from 320 to 1920 pixels wide."}},{"@type":"Question","name":"Can I screenshot one element instead of the whole page?","acceptedAnswer":{"@type":"Answer","text":"Yes: screenshot_options takes a CSS selector and captures just that element. A selector that matches nothing is a 422, and costs nothing."}},{"@type":"Question","name":"Do I need an SDK to call URLpipe from Java?","acceptedAnswer":{"@type":"Answer","text":"No SDK. HttpClient is in the JDK; the programs that read JSON add Gson, one jar, because the JDK has no parser."}}]},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://urlpipe.dev/"},{"@type":"ListItem","position":2,"name":"Code recipes","item":"https://urlpipe.dev/code"},{"@type":"ListItem","position":3,"name":"Java","item":"https://urlpipe.dev/code/java"},{"@type":"ListItem","position":4,"name":"Take a screenshot of a website in Java","item":"https://urlpipe.dev/code/java/screenshot"}]},{"@type":"HowTo","name":"Take a screenshot of a website in Java","description":"To take a screenshot of a website in Java, POST its URL to https://urlpipe.dev/screenshot with sync set to true, decode the Base64 body with Base64.getDecoder() and write the bytes to a .png file. It is a full-page capture from real Chrome for 1 credit; leave sync out and the result goes to your webhook instead.","url":"https://urlpipe.dev/code/java/screenshot","tool":[{"@type":"HowToTool","name":"Java 17+"}],"step":[{"@type":"HowToStep","name":"Before you start","text":"Java 17 or later: java.net.http is in the JDK. The async and error-handling programs read JSON, and the JDK has no parser, so those use Gson — one jar, no dependencies of its own. In a Maven or Gradle build add com.google.code.gson:gson:2.13.1; to try a file on its own, download the jar next to it.","url":"https://urlpipe.dev/code/java/screenshot#setup"},{"@type":"HowToStep","name":"Save a screenshot as a PNG file","text":""sync": true keeps the request open until the result is ready. BodyHandlers.ofString() reads the whole body as text, decoded with the charset the response names. HttpClient does not throw on a 4xx or 5xx, so check statusCode(). The body is Base64 text; Base64.getDecoder() gives the bytes back.","url":"https://urlpipe.dev/code/java/screenshot#sync"},{"@type":"HowToStep","name":"The async variant: a token, a webhook and a poll","text":"Leave out sync and the answer is a token, straight away. One HttpClient is shared by every call — it holds the connection pool, so build it once — and a switch expression covers the answers GET /result/:token can give.","url":"https://urlpipe.dev/code/java/screenshot#async"},{"@type":"HowToStep","name":"Handle errors and retries","text":"A checked URLpipeException makes the caller decide what a refusal means. firstValueAsLong reads Retry-After without a parse of your own, and a body that is not JSON (a proxy in front of the API can answer in HTML) falls back to an empty object.","url":"https://urlpipe.dev/code/java/screenshot#errors"}]}]}