Convert Url to Pdf

This endpoint allows you to convert any publicly accessible Url into a Pdf.

GET

https://api.cloudlayer.io/v1/url/pdf

Make a GET request to convert url to PDF, accepts simple options as query strings in URL (does not support advanced options).

POST

https://api.cloudlayer.io/v1/url/pdf

Make a POST request to convert url to PDF, accepts advanced options in JSON body.

GET

/url/pdf

This endpoint is for simple URL to PDF requests that do not require advanced options, if you need advanced options you should use the POST method described below.

This endpoint supports a few configuration options specified in the table below. These options are passed into the method as URL query strings.

Param	Description
`url` (string)	Source URL to use for generating the PDF Required
`timeout` (number)	Amount of time that Chrome is allowed to run, if exceeded your job will be terminated and you will not be charged. Default: 30000 ms (30 seconds)

schema
{
  "url": "",
  "timeout": 30000
}Copied!

Example

    wget --header="X-API-Key: <api-key>" \
"https://api.cloudlayer.io/v1/url/pdf?url=https://google.com" \
-O google.jpgCopied!

POST

/url/pdf

This endpoint allows full configuration options to be defined for converting a URL to a PDF.

Param Description

url

(string)

Source URL to use for generating the PDF

Required

timeout

(number)

Amount of time that Chrome is allowed to run, if exceeded your job will be terminated and you will not be charged.

Default: 30000 ms (30 seconds)

delay

(number)

The amount of time in milliseconds to wait for the page to complete rendering before conversion.

Default: 0

filename

(string)

If used with the inline:false, will set the Content-Disposition filename so that the downloaded file will be set to this value in the users browser. For inline:true it has no effect.

Default: 'file.pdf'

inline

(boolean)

If set to true, set's the Content-Disposition to 'inline', if set to false it will set the Content-Disposition to 'attachment'. See 'filename' property if you want to set the filename value for the attachment.

Default: false

waitForSelector

(waitForSelector)

selector

(string)

A selector of an element on the page to wait for until starting conversion.

options

(waitForSelectorOptions)

Different wait options

`visible` (boolean)	Wait until the selector is visible. If you set hidden to true, it will negate this option.
`hidden` (boolean)	Wait until the selector is hidden. If you set visible to true, it will negate this option.
`timeout` (number)	Amount of time to wait for either of the options within waitForSelector to complete before aborting the request. This is inclusive to timeout property, and delay is additive occurring after this completes.

preferCSSPageSize

(boolean)

Give any CSS @page size declared in the page priority over what is declared in width and height or format options.

Default: false

scale

(boolean)

Scale of the webpage rendering. Defaults to 1. Scale amount must be between 0.1 and 2.

Default: 1

height

(string)

Paper height, accepts values labeled with units.

Default: (empty)

width

(string)

Paper width, accepts values labeled with units.

Default: (empty)

landscape

(boolean)

Paper orientation, false sets it to portrait and true to landscape.

Default: false

pageRanges

(string)

Paper ranges to print, e.g., '1-5, 8, 11-13'. Defaults to the empty string, which means print all pages.

Default: (empty"

autoScroll

(boolean)

Will attempt to auto scroll the page down to the very end. Useful for forcing lazy-loaded content to load.

Default: false

waitUntil

(waitUntil)

When to consider navigation succeeded, defaults to networkidle2 Must be one one of the following values: load, domcontentloaded, networkidle0, networkidle2.

`load`	Consider navigation to be finished when the load event is fired.
`domcontentloaded`	Consider navigation to be finished when the DOMContentLoaded event is fired.
`networkidle0`	Consider navigation to be finished when there are no more than 0 network connections for at least 500 ms.
`networkidle2`	Consider navigation to be finished when there are no more than 2 network connections for at least 500 ms.

format

(string)

Paper format to render the PDF. Must be one of the following values in the table below.

`Letter`	8.5in x 11in (Default)
`Legal`	8.5in x 14in
`Tabloid`	17in x 11in
`Ledger`	11in x 17in
`A0`	33.1in x 46.8in
`A1`	23.4in x 33.1in

`A2`	16.54in x 23.4in
`A3`	11.7in x 16.54in
`A4`	8.27in x 11.7in
`A5`	5.83in x 8.27in
`A6`	4.13in x 5.83in

margin

(margin)

Paper margins for top, bottom, right, left.

`top`	in, px, cm, mm Default: 0.4in
`bottom`	in, px, cm, mm Default: 0.39in

`right`	in, px, cm, mm Default: 0.39in
`left`	in, px, cm, mm Default: 0.4in

printBackground

(boolean)

Print background graphics.

Default: true

headerTemplate

(headerFooterTemplate)

margin

(margin)

Margin for the Header

style

(CssStyle)

CSS Style for the header outer container.

imageStyle

(CssStyle)

CSS Style for the image inside the header container.

method

(string)

Type of header template.

`text` (string)	Use the default text template method.
`extract` (string)	Extracts the header from the HTML.

selector

(string)

The selector to use to find the header container in the HTML.

template

(string)

The template string if using template type of text.

footerTemplate

(headerFooterTemplate)

margin

(margin)

Margin for the Header

style

(CssStyle)

CSS Style for the header outer container.

imageStyle

(CssStyle)

CSS Style for the image inside the header container.

method

(string)

Type of header template.

`text` (string)	Use the default text template method.
`extract` (string)	Extracts the header from the HTML.

selector

(string)

The selector to use to find the header container in the HTML.

template

(string)

The template string if using template type of text.

schema
{
  "url": "",
  "timeout": 30000,
  "delay": 0,
  "filename": "file.pdf",
  "inline": false,
  "waitForSelector": {
    "selector": "",
    "options": {
      "visible": false,
      "hidden": false,
      "timeout": 0
    }
  },
  "preferCSSPageSize": false,
  "scale": 1,
  "height": "",
  "width": "",
  "landscape": false,
  "pageRanges": "",
  "autoScroll": false,
  "waitUntil": "networkidle2",
  "format": "Letter",
  "margin": {
    "bottom": "0.39in",
    "top": "0.4in",
    "left": "0.4in",
    "right": "0.39in"
  },
  "printBackground": true,
  "headerTemplate": {
    "margin": {
      "bottom": "",
      "top": "",
      "left": "",
      "right": ""
    },
    "style": "{ ...CssStyles }",
    "imageStyle": "{ ...CssStyles }",
    "method": "extract",
    "selector": "",
    "template": ""
  },
  "footerTemplate": {
    "margin": {
      "bottom": "",
      "top": "",
      "left": "",
      "right": ""
    },
    "style": "{ ...CssStyles }",
    "imageStyle": "{ ...CssStyles }",
    "method": "extract",
    "selector": "",
    "template": ""
  }
}Copied!

Example

wget
wget --method POST \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--body-data '{
  "url": "https://en.wikipedia.org/wiki/Mark_Twain"
}' \
https://api.cloudlayer.io/v1/url/pdfCopied!

View Example PDF