{"info":{"_postman_id":"41c5016d-d771-4de5-99a9-2c4008ffcf75","name":"BrowserGrab API","description":"

Screenshot any URL with a single POST request.

Setup:

Open this collection's Variables tab
\n
Set api_key to your key from https://browsergrab.app/dashboard/keys
\n

All requests use YOUR_API_KEY_HERE and hit https://browsergrab.app by default.

V1.0

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25858855","collectionId":"41c5016d-d771-4de5-99a9-2c4008ffcf75","publishedId":"2sBXitD7Ye","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-11T23:52:52.000Z"},"item":[{"name":"Screenshot API","item":[{"name":"Basic screenshot","id":"9831222f-f25f-4f45-b5e7-3ba49e779508","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

The minimum request. Just a URL.

Defaults:

format: png
width: 1280
height: 800
storage: cloud
fullPage: false
waitFor: 0

Returns a permanent public CDN URL to the screenshot.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"9831222f-f25f-4f45-b5e7-3ba49e779508"},{"name":"All options","id":"3bc1e035-628b-4435-86f2-1cad608eeca8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\",\n\n \"format\": \"png\",\n \"width\": 1280,\n \"height\": 800,\n \"fullPage\": false,\n \"waitFor\": 0,\n \"storage\": \"cloud\",\n\n \"retina\": false,\n \"darkMode\": false,\n \"blockAds\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Every available parameter shown with its default value. Edit what you need and delete the rest.

url (required)\nThe page to capture. Must be a valid http/https URL.

format — png | jpeg | webp\nOutput image format. Default: png

width — integer, 320–3840\nBrowser viewport width in pixels. Default: 1280. Max 1920 on Free, 3840 on Super.

height — integer, 240–2160\nBrowser viewport height in pixels. Default: 800.

fullPage — boolean\nCaptures the entire scrollable page, not just the visible viewport. Default: false.

waitFor — integer, 0–5000\nExtra milliseconds to wait after page load before capturing. Useful for pages with animations or lazy-loaded content. Default: 0.

storage — cloud | gdrive | none

cloud: stores on BrowserGrab CDN, returns a permanent URL (Super plan)
gdrive: saves to your connected Google Drive (Super plan)
none: returns a base64 data URL in the response, nothing stored remotely (all plans)\nDefault: cloud

retina — boolean\n2× device pixel ratio capture (doubles resolution). Super plan only. Default: false.

darkMode — boolean\nForces the page into dark mode via the prefers-color-scheme media query. Super plan only. Default: false.

blockAds — boolean\nBlocks ads and trackers before capturing. Super plan only. Default: false.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"3bc1e035-628b-4435-86f2-1cad608eeca8"},{"name":"Full page capture","id":"9c599d66-fd66-42f6-a5f5-81616c967aa8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://stripe.com\",\n \"fullPage\": true,\n \"format\": \"png\",\n \"width\": 1280\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Captures the entire scrollable height of the page, not just the viewport. The height parameter is ignored when fullPage is true — the browser determines the full document height automatically.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"9c599d66-fd66-42f6-a5f5-81616c967aa8"},{"name":"Mobile viewport (375×812)","id":"dd899463-f1dd-4efc-984b-036021a9b6df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\",\n \"width\": 375,\n \"height\": 812,\n \"format\": \"png\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

iPhone 14 viewport. Responsive sites will render their mobile layout at this width.

Common mobile sizes:

375×812 — iPhone 14
390×844 — iPhone 14 Pro
360×800 — Android standard
768×1024 — iPad portrait

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"dd899463-f1dd-4efc-984b-036021a9b6df"},{"name":"Wait for animations","id":"42c30873-ebb8-4b74-934f-18518818d4df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\",\n \"waitFor\": 2000,\n \"format\": \"png\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Waits an extra 2000ms after page load before capturing. Use this for pages with entrance animations, charts that render after load, or lazy-loaded images.

Max: 5000ms. Each millisecond counts against your quota's response time but does not cost extra captures.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"42c30873-ebb8-4b74-934f-18518818d4df"},{"name":"Super — Retina + dark mode + block ads","id":"c5e865ca-5dde-4a7f-9691-e575f51b36d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://github.com\",\n \"format\": \"png\",\n \"width\": 1280,\n \"height\": 800,\n \"retina\": true,\n \"darkMode\": true,\n \"blockAds\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Super plan features — all three can be combined freely.

retina: true — captures at 2560×1600 effective pixels (2× DPR), output image is full 2560px wide
darkMode: true — forces prefers-color-scheme: dark on the page
blockAds: true — blocks ads and trackers before capture for a cleaner result

Requires Super plan. Returns 403 if used on a Free account.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"c5e865ca-5dde-4a7f-9691-e575f51b36d5"},{"name":"Return as base64 (no storage)","id":"03f8e258-976a-4c80-afda-9bddb0e535cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\",\n \"format\": \"png\",\n \"storage\": \"none\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Nothing is stored remotely. The response data.url is a data:image/png;base64,... string you can decode or drop straight into an tag.

Available on all plans. Use this when you want to handle storage yourself or process the image immediately server-side.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"03f8e258-976a-4c80-afda-9bddb0e535cb"},{"name":"Bulk screenshots (multiple URLs)","id":"98e00bd5-65cd-4306-9219-8a206c0e4dd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"urls\": [\n \"https://example.com\",\n \"https://github.com\",\n \"https://stripe.com\"\n ],\n \"format\": \"png\",\n \"width\": 1280,\n \"height\": 800,\n \"storage\": \"cloud\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Capture multiple URLs in a single request. Each URL counts as one credit against your monthly quota.

Two ways to send multiple URLs:

urls array (recommended):

{ \"urls\": [\"https://a.com\", \"https://b.com\"] }\n

url as comma-separated string:

{ \"url\": \"https://a.com,https://b.com,https://c.com\" }\n

Limits:

Maximum 20 URLs per request
All URLs must pass the same format, width, height, and storage settings
The full batch is rejected if you don't have enough quota for all URLs

Bulk response shape:

{\n  \"success\": true,\n  \"count\": 3,\n  \"captured\": 2,\n  \"failed\": 1,\n  \"results\": [\n    { \"url\": \"https://example.com\", \"success\": true, \"data\": { \"url\": \"...\", \"width\": 1280, \"height\": 800, \"format\": \"png\", \"storage\": \"cloud\" }, \"charged\": true },\n    { \"url\": \"https://github.com\",  \"success\": true, \"data\": { ... }, \"charged\": true },\n    { \"url\": \"https://bad-url.xyz\", \"success\": false, \"error\": \"dns_error\", \"message\": \"DNS lookup failed\", \"charged\": false }\n  ]\n}\n

Failed captures (DNS errors, blank pages) are not charged but do not halt the batch — the other URLs still capture normally.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"98e00bd5-65cd-4306-9219-8a206c0e4dd9"},{"name":"Save to Google Drive","id":"0d3b3651-341b-48d0-84cd-2c77497fac56","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\",\n \"format\": \"png\",\n \"storage\": \"gdrive\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

Saves the screenshot directly to your connected Google Drive and returns a shareable Drive link.

Requirements:

Super plan
Google Drive connected in your Account settings at https://browsergrab.app/dashboard/account

Returns a standard Google Drive file URL that can be shared or embedded.

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"0d3b3651-341b-48d0-84cd-2c77497fac56"}],"id":"09582953-8fbf-48fe-98b4-492fce6af0ed","description":"

All requests hit the same endpoint: POST /api/screenshot

Authentication: Bearer token via the Authorization header.

All parameters except url are optional.

\n","_postman_id":"09582953-8fbf-48fe-98b4-492fce6af0ed"},{"name":"Response reference","item":[{"name":"Success response shape","id":"9b81a523-799d-4e17-b57d-b53984ea3404","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer YOUR_API_KEY_HERE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com\"\n}","options":{"raw":{"language":"json"}}},"url":"https://browsergrab.app/api/screenshot","description":"

A successful 200 response always looks like this:

{\n  \"success\": true,\n  \"data\": {\n    \"url\": \"https://pub-....r2.dev/screenshots/2025-01/abc123.png\",\n    \"width\": 1280,\n    \"height\": 800,\n    \"format\": \"png\",\n    \"storage\": \"cloud\"\n  }\n}\n

data.url is what you store or display. For storage: none it is a base64 data URL instead.

Error responses:

{ \"error\": \"quota_exceeded\", \"current\": 15, \"limit\": 15 }\n{ \"error\": \"unauthorized\" }\n{ \"error\": \"dimension_exceeds_plan\", \"message\": \"...\" }\n{ \"error\": \"page_load_failed\", \"charged\": false }\n

Status codes:

200 — success
400 — bad request (invalid body or unsafe URL)
401 — missing or invalid API key
403 — feature not available on your plan
422 — page failed to load (DNS error, blank page) — not charged
429 — monthly quota exceeded
500 — internal server error

\n","urlObject":{"path":["api","screenshot"],"host":["https://browsergrab.app"],"query":[],"variable":[]}},"response":[],"_postman_id":"9b81a523-799d-4e17-b57d-b53984ea3404"}],"id":"b4cd0db5-7f90-4495-afb4-b51388e56c58","description":"

Expected responses from the API.

\n","_postman_id":"b4cd0db5-7f90-4495-afb4-b51388e56c58"}],"variable":[{"key":"api_key","value":"YOUR_API_KEY_HERE"},{"key":"base_url","value":"https://browsergrab.app"}]}