Get Started
Templating
API Documentation
Sync/Async options
curl --request POST \
--url https://api.doczilla.app/v1/pdf \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"page": {
"url": "<string>",
"html": "<string>",
"htmlTemplate": "<string>",
"templateData": {},
"waitUntil": "auto",
"waitForMilliseconds": 2500,
"waitForSelector": {
"selector": "<string>",
"options": {
"visible": false,
"hidden": false,
"timeout": 10000
}
},
"waitForFunction": {
"pageFunction": "window.innerWidth < 100",
"options": {
"polling": "raf",
"timeout": 10000
}
},
"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>"
},
"pdf": {
"scale": 1,
"displayHeaderFooter": false,
"headerHtml": "<string>",
"footerHtml": "<string>",
"printBackground": false,
"landscape": false,
"pageRanges": "1-5",
"format": "letter",
"width": "<string>",
"height": "<string>",
"preferCSSPageSize": false,
"margin": {
"top": "<string>",
"bottom": "<string>",
"left": "<string>",
"right": "<string>"
},
"omitBackground": false,
"outline": false,
"tagged": false
}
}
'"<string>"Create PDF
Create a PDF and directly return the raw result.
curl --request POST \
--url https://api.doczilla.app/v1/pdf \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"page": {
"url": "<string>",
"html": "<string>",
"htmlTemplate": "<string>",
"templateData": {},
"waitUntil": "auto",
"waitForMilliseconds": 2500,
"waitForSelector": {
"selector": "<string>",
"options": {
"visible": false,
"hidden": false,
"timeout": 10000
}
},
"waitForFunction": {
"pageFunction": "window.innerWidth < 100",
"options": {
"polling": "raf",
"timeout": 10000
}
},
"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>"
},
"pdf": {
"scale": 1,
"displayHeaderFooter": false,
"headerHtml": "<string>",
"footerHtml": "<string>",
"printBackground": false,
"landscape": false,
"pageRanges": "1-5",
"format": "letter",
"width": "<string>",
"height": "<string>",
"preferCSSPageSize": false,
"margin": {
"top": "<string>",
"bottom": "<string>",
"left": "<string>",
"right": "<string>"
},
"omitBackground": false,
"outline": false,
"tagged": false
}
}
'"<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.
Show child attributes
Show child attributes
URL to go to. Should include the scheme, e.g. https://
HTML to render. Needs to be base64 encoded!
HTML template to render, uses Handlebars to render your HTML together with the provided templateData. 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 "auto"
Wait for a certain amount of milliseconds before the request continues.
0 <= x <= 5000Show child attributes
Show child attributes
Options for configuring waiting behavior.
Show child attributes
Show child attributes
Wait for the selected element to be present in DOM and to be visibleAn element is considered to be visible if all of the following is true:
- the element has computed styles
- the element has a non-empty bounding client rect
- the element's visibility is not
hiddenorcollapse
false
Wait for the selected element to not be found in the DOM or to be hidden.An element is considered to be hidden if at least one of the following is true:
- the element has no computed styles
- the element has an empty bounding client rect
- the element's visibility is
hiddenorcollapse
false
Maximum time to wait in milliseconds.
1 <= x <= 3000010000
Wait for the pageFunction to execute in the page. If the pageFunction doesn't execute successfully after the timeout milliseconds of waiting, the request will continue.
Show child attributes
Show child attributes
Function to be evaluated in browser context until it returns a truthy value.
1 - 1024"window.innerWidth < 100"
Options for configuring waiting behavior.
Show child attributes
Show child attributes
An interval at which the pageFunction is executed, defaults to raf. If polling is a number, then it is treated as an interval in milliseconds at which the function would be executed. If polling is a string, then it can be one of the following values:
rafto constantly executepageFunctioninrequestAnimationFramecallback. This is the tightest polling mode which is suitable to observe styling changes.mutationto executepageFunctionon every DOM mutation.
raf, mutation "raf"
Maximum time to wait in milliseconds.
1 <= x <= 3000010000
An object containing additional HTTP headers to be sent with every request. All header values must be strings.
{ "x-foo": "bar" }Use our build-in adblocker.
true
Whether or not to enable JavaScript on the page.
true
Cookies added to the page, Also accepted as string inside headers.cookie.
Show child attributes
Show child attributes
Cookie name.
1 - 1024Cookie value.
1 - 4096Cookie domain.
1 - 512The 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.
1 - 512true 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.
Color-scheme to set on the page.
20Changes 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.
Show child attributes
Show child attributes
Scales the rendering of the web page. Amount must be between 0.1 and 2.
0.1 <= x <= 21
Whether to show the header and footer.
false
HTML template for the print header. Should be valid HTML (base64 encoded) with the following classes used to inject values into them:
dateformatted print datetitledocument titleurldocument locationpageNumbercurrent page numbertotalPagestotal pages in the document
HTML template for the print footer. Has the same constraints and support for special classes as headerHtml.
Set to true to print background graphics.
false
Whether to print in landscape orientation.
false
Paper ranges to print, e.g. 1-5, 8, 11-13.
"1-5"
If set, this takes priority over the width and height options.
The sizes of each format are as follows:
letter8.5in x 11inlegal8.5in x 14intabloid11in x 17inledger17in x 11ina033.1in x 46.8ina123.4in x 33.1ina216.54in x 23.4ina311.7in x 16.54ina48.27in x 11.7ina55.83in x 8.27ina64.13in x 5.83in
letter, legal, tabloid, ledger, a0, a1, a2, a3, a4, a5, a6 "letter"
Sets the width of paper. You can pass in a number or a string with a unit.
Sets the height of paper. You can pass in a number or a string with a unit.
Hides default white background and allows generating pdfs with transparency.
false
Generate document outline. If this is enabled the PDF will also be tagged (accessible).
false
Generate tagged (accessible) PDF. This is experimental and will increase the size of the PDF.
false
Response
Raw PDF document
Was this page helpful?