Create screenshot sync
Create a screenshot and directly return a document URL instead of the raw document. Optionally writes the document directly into your bucket, bypassing the need for our temporary storage.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Page options, either provide the url, html or htmlTemplate option.
URL to go to. Should include the scheme, e.g. https://
HTML to render. Needs to be base64 encoded!
HTML template to render. Needs to be base64 encoded!
Template data, only used in combination with page.htmlTemplate.
When to consider waiting succeeds.
autoour smart waiting option that can handle 90% of the cases.loadwaits for the 'load' event.domcontentloadedwaits for the 'DOMContentLoaded' event.networkidle0waits till there are no more than 0 network connections for at least500ms.networkidle2waits till there are no more than 2 network connections for at least500ms.
An object containing additional HTTP headers to be sent with every request. All header values must be strings.
Use our build-in adblocker.
Whether or not to enable JavaScript on the page.
Cookies added to the page, Also accepted as string inside headers.cookie.
Provide credentials for HTTP authentication.
Color-scheme to set on the page.
Changes the CSS media type of the page.
Changes the timezone of the page. See ICU’s metaZones.txt for a list of supported timezone IDs.
Device preset to use, will not be set when viewport option is provided!
Define an custom viewport, when defined the device option will be ignored!
The page width in CSS pixels.
The page height in CSS pixels.
Specify device scale factor. See devicePixelRatio for more info.
Whether the meta viewport tag is taken into account.
Specify if the viewport supports touch events.
Specifies if the viewport is in landscape mode.
When true, takes a screenshot of the full page.
Capture the screenshot from the surface, rather than the view.
Hides default white background and allows capturing screenshots with transparency.
Quality of the image, between 0-100. Not applicable to png images.
Capture the screenshot beyond the viewport. false if there is no clip. true otherwise.
Specifies the region of the page to clip.
The width of the element in pixels.
The height of the element in pixels.
It captures the DOM element matching the given CSS selector. This will overwrite the clip property and set fullPage to false.
Add an overlay to the image. Cannot be used together with the fullPage option!
Color to apply as background, can be an an hexadecimal/rgb/rgba color code or CSS gradient.
Apply CSS Filter to background.
Margin to apply.
Browser to apply.
The border radius, specified in CSS pixels, is applied to the screenshot only when the device option is not set.
Pre-signed url to upload the generated pdf/screenshot to. Should include the scheme, e.g. https://
curl --request POST \
--url https://api.doczilla.app/v1/screenshot/sync \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page": {
"url": "<string>",
"html": "<string>",
"htmlTemplate": "<string>",
"templateData": {},
"waitUntil": "auto",
"headers": {
"x-foo": "bar"
},
"adblock": true,
"javascript": true,
"cookies": [
{
"name": "<string>",
"value": "<string>",
"domain": "<string>",
"url": "<string>",
"path": "<string>",
"secure": true,
"httpOnly": true,
"sameSite": "Strict",
"expires": 123
}
],
"authentication": {
"username": "<string>",
"password": "<string>"
},
"colorScheme": "<string>",
"mediaType": "screen",
"timezone": "<string>"
},
"screenshot": {
"type": "png",
"device": "Macbook Pro 16",
"viewport": {
"width": 2240,
"height": 1260,
"deviceScaleFactor": 1,
"isMobile": true,
"hasTouch": true,
"isLandscape": true
},
"fullPage": true,
"fromSurface": true,
"omitBackground": true,
"optimizeForSpeed": true,
"quality": 50,
"captureBeyondViewport": true,
"clip": {
"scale": 1,
"width": 123,
"height": 123,
"x": 123,
"y": 123
},
"element": "<string>",
"overlay": {
"background": "<string>",
"filter": "none",
"margin": 0.2,
"browser": "light",
"screenshotBorderRadius": 123
}
},
"storage": {
"preSignedUrl": "<string>"
}
}'{
"id": "5KqYNUjbxRJ-rKbIeGsXo",
"status": "PENDING",
"fileUrl": "<string>",
"signedUrlStatus": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Page options, either provide the url, html or htmlTemplate option.
URL to go to. Should include the scheme, e.g. https://
HTML to render. Needs to be base64 encoded!
HTML template to render. Needs to be base64 encoded!
Template data, only used in combination with page.htmlTemplate.
When to consider waiting succeeds.
autoour smart waiting option that can handle 90% of the cases.loadwaits for the 'load' event.domcontentloadedwaits for the 'DOMContentLoaded' event.networkidle0waits till there are no more than 0 network connections for at least500ms.networkidle2waits till there are no more than 2 network connections for at least500ms.
auto, load, domcontentloaded, networkidle0, networkidle2 An object containing additional HTTP headers to be sent with every request. All header values must be strings.
Use our build-in adblocker.
Whether or not to enable JavaScript on the page.
Cookies added to the page, Also accepted as string inside headers.cookie.
Cookie name.
Cookie value.
Cookie domain.
The request-URI to associate with the setting of the cookie. This value can affect the default domain, path, source port, and source scheme values of the created cookie. Should include the scheme, e.g. https://
Cookie path.
true if cookie is secure.
true if cookie is http-only.
Cookie SameSite type.
Strict, Lax, None Cookie expiration date (UTC time in seconds, counted from January 1, 1970.), session cookie if not set.
Provide credentials for HTTP authentication.
Color-scheme to set on the page.
Changes the CSS media type of the page.
screen, print Changes the timezone of the page. See ICU’s metaZones.txt for a list of supported timezone IDs.
png, jpeg, webp Device preset to use, will not be set when viewport option is provided!
Blackberry PlayBook, Blackberry PlayBook landscape, BlackBerry Z30, BlackBerry Z30 landscape, Galaxy Note 3, Galaxy Note 3 landscape, Galaxy Note II, Galaxy Note II landscape, Galaxy S III, Galaxy S III landscape, Galaxy S5, Galaxy S5 landscape, Galaxy S8, Galaxy S8 landscape, Galaxy S9+, Galaxy S9+ landscape, Galaxy Tab S4, Galaxy Tab S4 landscape, iPad, iPad landscape, iPad (gen 6), iPad (gen 6) landscape, iPad (gen 7), iPad (gen 7) landscape, iPad Mini, iPad Mini landscape, iPad Pro, iPad Pro landscape, iPad Pro 11, iPad Pro 11 landscape, iPhone 4, iPhone 4 landscape, iPhone 5, iPhone 5 landscape, iPhone 6, iPhone 6 landscape, iPhone 6 Plus, iPhone 6 Plus landscape, iPhone 7, iPhone 7 landscape, iPhone 7 Plus, iPhone 7 Plus landscape, iPhone 8, iPhone 8 landscape, iPhone 8 Plus, iPhone 8 Plus landscape, iPhone SE, iPhone SE landscape, iPhone X, iPhone X landscape, iPhone XR, iPhone XR landscape, iPhone 11, iPhone 11 landscape, iPhone 11 Pro, iPhone 11 Pro landscape, iPhone 11 Pro Max, iPhone 11 Pro Max landscape, iPhone 12, iPhone 12 landscape, iPhone 12 Pro, iPhone 12 Pro landscape, iPhone 12 Pro Max, iPhone 12 Pro Max landscape, iPhone 12 Mini, iPhone 12 Mini landscape, iPhone 13, iPhone 13 landscape, iPhone 13 Pro, iPhone 13 Pro landscape, iPhone 13 Pro Max, iPhone 13 Pro Max landscape, iPhone 13 Mini, iPhone 13 Mini landscape, JioPhone 2, JioPhone 2 landscape, Kindle Fire HDX, Kindle Fire HDX landscape, LG Optimus L70, LG Optimus L70 landscape, Microsoft Lumia 550, Microsoft Lumia 950, Microsoft Lumia 950 landscape, Nexus 10, Nexus 10 landscape, Nexus 4, Nexus 4 landscape, Nexus 5, Nexus 5 landscape, Nexus 5X, Nexus 5X landscape, Nexus 6, Nexus 6 landscape, Nexus 6P, Nexus 6P landscape, Nexus 7, Nexus 7 landscape, Nokia Lumia 520, Nokia Lumia 520 landscape, Nokia N9, Nokia N9 landscape, Pixel 2, Pixel 2 landscape, Pixel 2 XL, Pixel 2 XL landscape, Pixel 3, Pixel 3 landscape, Pixel 4, Pixel 4 landscape, Pixel 4a (5G), Pixel 4a (5G) landscape, Pixel 5, Pixel 5 landscape, Moto G4, Moto G4 landscape, Macbook Pro 13, Macbook Pro 15, Macbook Pro 16, iMac 21, iMac 21 4K, iMac 24 4.5K, iMac 27, iMac 27 5K Define an custom viewport, when defined the device option will be ignored!
The page width in CSS pixels.
The page height in CSS pixels.
Specify device scale factor. See devicePixelRatio for more info.
Whether the meta viewport tag is taken into account.
Specify if the viewport supports touch events.
Specifies if the viewport is in landscape mode.
When true, takes a screenshot of the full page.
Capture the screenshot from the surface, rather than the view.
Hides default white background and allows capturing screenshots with transparency.
Quality of the image, between 0-100. Not applicable to png images.
Capture the screenshot beyond the viewport. false if there is no clip. true otherwise.
Specifies the region of the page to clip.
The width of the element in pixels.
The height of the element in pixels.
It captures the DOM element matching the given CSS selector. This will overwrite the clip property and set fullPage to false.
Add an overlay to the image. Cannot be used together with the fullPage option!
Color to apply as background, can be an an hexadecimal/rgb/rgba color code or CSS gradient.
Apply CSS Filter to background.
Margin to apply.
Browser to apply.
light, dark The border radius, specified in CSS pixels, is applied to the screenshot only when the device option is not set.
Pre-signed url to upload the generated pdf/screenshot to. Should include the scheme, e.g. https://
Response
Id of the queued job.
Status of the job.
PENDING, RUNNING, FAILED, COMPLETED URL to the generated file (will be null if storage.signedUrl is used). This url is valid for 1 hour, after that the file will be deleted from our storage.
Status of the signed url request if provided.
NOT_PROVIDED, nostorage.preSignedUrlwas provided.UPLOADED,storage.preSignedUrlwas provided and file is uploaded.FAILED,storage.preSignedUrlwas provided but the upload failed.
Was this page helpful?
curl --request POST \
--url https://api.doczilla.app/v1/screenshot/sync \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page": {
"url": "<string>",
"html": "<string>",
"htmlTemplate": "<string>",
"templateData": {},
"waitUntil": "auto",
"headers": {
"x-foo": "bar"
},
"adblock": true,
"javascript": true,
"cookies": [
{
"name": "<string>",
"value": "<string>",
"domain": "<string>",
"url": "<string>",
"path": "<string>",
"secure": true,
"httpOnly": true,
"sameSite": "Strict",
"expires": 123
}
],
"authentication": {
"username": "<string>",
"password": "<string>"
},
"colorScheme": "<string>",
"mediaType": "screen",
"timezone": "<string>"
},
"screenshot": {
"type": "png",
"device": "Macbook Pro 16",
"viewport": {
"width": 2240,
"height": 1260,
"deviceScaleFactor": 1,
"isMobile": true,
"hasTouch": true,
"isLandscape": true
},
"fullPage": true,
"fromSurface": true,
"omitBackground": true,
"optimizeForSpeed": true,
"quality": 50,
"captureBeyondViewport": true,
"clip": {
"scale": 1,
"width": 123,
"height": 123,
"x": 123,
"y": 123
},
"element": "<string>",
"overlay": {
"background": "<string>",
"filter": "none",
"margin": 0.2,
"browser": "light",
"screenshotBorderRadius": 123
}
},
"storage": {
"preSignedUrl": "<string>"
}
}'{
"id": "5KqYNUjbxRJ-rKbIeGsXo",
"status": "PENDING",
"fileUrl": "<string>",
"signedUrlStatus": "<string>"
}