There is no official Java SDK. java.net.http.HttpClient, standard since Java 11, handles the whole API. The JSON below is written out literally to keep the example dependency-free; use Jackson or Gson in real code.

Install

// nothing to install - java.net.http is built in (Java 11+)

Your first screenshot in Java

One POST, one JSON body, one URL back. The response is a CDN link to the finished image.

java.net.http

import java.net.URI;
import java.net.http.*;
import java.time.Duration;

public class Screenshot {
    public static void main(String[] args) throws Exception {
        String payload = """
            {"url": "https://github.com", "format": "png"}
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.getsnap.dev/v1/screenshot"))
            .header("X-API-Key", "sk_live_YOUR_KEY")
            .header("Content-Type", "application/json")
            .timeout(Duration.ofSeconds(60))
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response =
            client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body()); // {"url": "https://cdn..."}
    }
}

Full-page captures and other options

Every option is a field in the same JSON body. The common ones are full-page capture, popup and ad removal, viewport size, and lazy-load scrolling.

String payload = """
    {
      "url": "https://example.com",
      "format": "png",
      "full_page": true,
      "remove_popups": true,
      "block_ads": true,
      "viewport_width": 1280,
      "viewport_height": 720
    }
    """;

Saving the image to disk

By default you get a CDN URL. Ask for a binary response instead and you get the bytes directly, which saves a round-trip when you are storing the file yourself.

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.getsnap.dev/v1/screenshot"))
    .header("X-API-Key", "sk_live_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"url": "https://example.com", "format": "webp",
         "quality": 90, "response_type": "binary"}
        """))
    .build();

HttpResponse<Path> response = client.send(
    request, HttpResponse.BodyHandlers.ofFile(Path.of("screenshot.webp")));

Handling errors

Every failure returns JSON with an error code and a human-readable message. These are the ones worth branching on:

Status	error	What it means
400	validation_error	A field is missing or out of range. The body names the field.
401	unauthorized	Missing or unknown API key.
402	quota_exceeded	Monthly capture limit reached.
429	rate_limit_exceeded	Too many requests this minute. Back off and retry.
500	capture_failed	The page could not be rendered - usually a timeout on a page that never settles.

HttpResponse<String> response =
    client.send(request, HttpResponse.BodyHandlers.ofString());

if (response.statusCode() != 200) {
    // body is {"error": "...", "message": "..."}
    throw new IllegalStateException(
        response.statusCode() + " " + response.body());
}

Rate limits and quotas

Plan	Captures / month	Requests / minute
Free	100	5
Starter	5,000	30
Pro	25,000	60
Business	100,000	120

Exceeding the per-minute limit returns 429; exceeding the monthly quota returns 402. See pricing for the full breakdown.

Frequently asked questions

Next steps

• Code examples — every feature, with cURL, Node.js and Python tabs
• API reference — every request field and response shape
• Playground — try a capture in the browser before writing any Java
• Pricing — plans, quotas and overage

Related reading

• Best screenshot API in 2026 — how the managed options compare