There is no official PHP SDK. None is needed - the API is a single JSON POST, so Guzzle or the bundled cURL extension is enough. Both are shown below.

Install

composer require guzzlehttp/guzzle

Your first screenshot in PHP

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

Guzzle

<?php
require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->post('https://api.getsnap.dev/v1/screenshot', [
    'headers' => ['X-API-Key' => 'sk_live_YOUR_KEY'],
    'json'    => ['url' => 'https://github.com', 'format' => 'png'],
    'timeout' => 60,
]);

$data = json_decode((string) $response->getBody(), true);
echo $data['url'];   // CDN URL to your screenshot

cURL extension (no dependencies)

<?php
$ch = curl_init('https://api.getsnap.dev/v1/screenshot');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: sk_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url'    => 'https://github.com',
        'format' => 'png',
    ]),
]);

$body = curl_exec($ch);
curl_close($ch);

echo json_decode($body, true)['url'];

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.

$response = $client->post('https://api.getsnap.dev/v1/screenshot', [
    'headers' => ['X-API-Key' => 'sk_live_YOUR_KEY'],
    'json' => [
        '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.

<?php
// response_type "binary" returns the image bytes instead of a JSON URL
$response = $client->post('https://api.getsnap.dev/v1/screenshot', [
    'headers' => ['X-API-Key' => 'sk_live_YOUR_KEY'],
    'json'    => [
        'url'           => 'https://example.com',
        'format'        => 'webp',
        'quality'       => 90,
        'response_type' => 'binary',
    ],
]);

file_put_contents('screenshot.webp', (string) $response->getBody());

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.

<?php
use GuzzleHttp\Exception\ClientException;

try {
    $response = $client->post('https://api.getsnap.dev/v1/screenshot', [
        'headers' => ['X-API-Key' => 'sk_live_YOUR_KEY'],
        'json'    => ['url' => 'https://example.com'],
    ]);
    echo json_decode((string) $response->getBody(), true)['url'];
} catch (ClientException $e) {
    $status = $e->getResponse()->getStatusCode();
    $body   = json_decode((string) $e->getResponse()->getBody(), true);
    // e.g. 402 quota_exceeded
    echo "$status {$body['error']}: {$body['message']}";
}

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 PHP
• Pricing — plans, quotas and overage

Related reading

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