API Reference

import requests

resp = requests.post(
    "https://api.snapapi.dev/v1/screenshot",
    headers={"Authorization": "Bearer sk_live_abc123"},
    json={"url": "https://example.com"},
)
print(resp.status_code)

const resp = await fetch("https://api.snapapi.dev/v1/screenshot", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_abc123",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com" }),
});
console.log(resp.status);

$ch = curl_init('https://api.snapapi.dev/v1/screenshot');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_abc123',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['url' => 'https://example.com']),
    CURLOPT_RETURNTRANSFER => true,
]);
$result = curl_exec($ch);

import requests

response = requests.post(
    "https://api.snapapi.dev/v1/screenshot",
    headers={"Authorization": "Bearer sk_live_abc123"},
    json={
        "url": "https://github.com",
        "viewport": {"width": 1440, "height": 900},
        "format": "png",
        "full_page": False,
        "dark_mode": True,
        "css": ".header-banner { display: none; }",
        "cache_ttl": 3600,
    },
)

with open("github.png", "wb") as f:
    f.write(response.content)

print(f"Status: {response.status_code}")
print(f"Cache: {response.headers.get('X-Cache')}")
print(f"Render time: {response.headers.get('X-Render-Time')}ms")

import { writeFileSync } from "node:fs";

const response = await fetch("https://api.snapapi.dev/v1/screenshot", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_abc123",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://github.com",
    viewport: { width: 1440, height: 900 },
    format: "png",
    full_page: false,
    dark_mode: true,
    css: ".header-banner { display: none; }",
    cache_ttl: 3600,
  }),
});

const buffer = Buffer.from(await response.arrayBuffer());
writeFileSync("github.png", buffer);
console.log(`Cache: ${response.headers.get("X-Cache")}`);

$ch = curl_init('https://api.snapapi.dev/v1/screenshot');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_abc123',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url'       => 'https://github.com',
        'viewport'  => ['width' => 1440, 'height' => 900],
        'format'    => 'png',
        'full_page' => false,
        'dark_mode' => true,
        'css'       => '.header-banner { display: none; }',
        'cache_ttl' => 3600,
    ]),
]);

$image = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

file_put_contents('github.png', $image);
echo "Status: $status\n";

import requests

response = requests.post(
    "https://api.snapapi.dev/v1/og-image",
    headers={"Authorization": "Bearer sk_live_abc123"},
    json={
        "template": "article",
        "title": "Building a Screenshot API from Scratch",
        "subtitle": "A deep dive into headless browsers, rendering pipelines, and edge caching.",
        "logo_url": "https://example.com/logo.png",
        "author": "Jane Developer",
        "date": "2026-05-26",
        "reading_time": "8 min read",
        "format": "png",
    },
)

with open("og-image.png", "wb") as f:
    f.write(response.content)

import { writeFileSync } from "node:fs";

const response = await fetch("https://api.snapapi.dev/v1/og-image", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_abc123",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template: "article",
    title: "Building a Screenshot API from Scratch",
    subtitle: "A deep dive into headless browsers, rendering pipelines, and edge caching.",
    logo_url: "https://example.com/logo.png",
    author: "Jane Developer",
    date: "2026-05-26",
    reading_time: "8 min read",
    format: "png",
  }),
});

writeFileSync("og-image.png", Buffer.from(await response.arrayBuffer()));

$ch = curl_init('https://api.snapapi.dev/v1/og-image');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_abc123',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'template'     => 'article',
        'title'        => 'Building a Screenshot API from Scratch',
        'subtitle'     => 'A deep dive into headless browsers and edge caching.',
        'logo_url'     => 'https://example.com/logo.png',
        'author'       => 'Jane Developer',
        'date'         => '2026-05-26',
        'reading_time' => '8 min read',
        'format'       => 'png',
    ]),
]);

file_put_contents('og-image.png', curl_exec($ch));
curl_close($ch);

import requests

response = requests.post(
    "https://api.snapapi.dev/v1/pdf",
    headers={"Authorization": "Bearer sk_live_abc123"},
    json={
        "url": "https://example.com/invoice/12345",
        "page_size": "A4",
        "orientation": "portrait",
        "margins": {
            "top": "20mm",
            "right": "15mm",
            "bottom": "20mm",
            "left": "15mm",
        },
        "print_background": True,
        "footer_html": '<div style="font-size:10px;text-align:center;width:100%">Page {{pageNumber}} of {{totalPages}}</div>',
    },
)

with open("invoice.pdf", "wb") as f:
    f.write(response.content)

import { writeFileSync } from "node:fs";

const response = await fetch("https://api.snapapi.dev/v1/pdf", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_abc123",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://example.com/invoice/12345",
    page_size: "A4",
    orientation: "portrait",
    margins: { top: "20mm", right: "15mm", bottom: "20mm", left: "15mm" },
    print_background: true,
    footer_html: `<div style="font-size:10px;text-align:center;width:100%">Page {{pageNumber}} of {{totalPages}}</div>`,
  }),
});

writeFileSync("invoice.pdf", Buffer.from(await response.arrayBuffer()));

$ch = curl_init('https://api.snapapi.dev/v1/pdf');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_abc123',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url'              => 'https://example.com/invoice/12345',
        'page_size'        => 'A4',
        'orientation'      => 'portrait',
        'margins'          => ['top' => '20mm', 'right' => '15mm', 'bottom' => '20mm', 'left' => '15mm'],
        'print_background' => true,
        'footer_html'      => '<div style="font-size:10px;text-align:center;width:100%">Page {{pageNumber}} of {{totalPages}}</div>',
    ]),
]);

file_put_contents('invoice.pdf', curl_exec($ch));
curl_close($ch);

import requests

response = requests.get(
    "https://api.snapapi.dev/v1/usage",
    headers={"Authorization": "Bearer sk_live_abc123"},
)

data = response.json()
print(f"Used: {data['usage']['total']} / {data['quota']['limit']}")
print(f"Remaining: {data['quota']['remaining']}")

const response = await fetch("https://api.snapapi.dev/v1/usage", {
  headers: { "Authorization": "Bearer sk_live_abc123" },
});

const data = await response.json();
console.log(`Used: ${data.usage.total} / ${data.quota.limit}`);
console.log(`Remaining: ${data.quota.remaining}`);

$ch = curl_init('https://api.snapapi.dev/v1/usage');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer sk_live_abc123'],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

echo "Used: {$data['usage']['total']} / {$data['quota']['limit']}\n";
echo "Remaining: {$data['quota']['remaining']}\n";