About this endpoint
What it does
Converts a public HTTP(S) webpage URL into a PDF. You send the page URL in the request body, and the endpoint returns the generated PDF as a binary response.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| url | String | Yes | Public http(s) URL of the page. |
| pdfa | ENUM | No | Archival format. Allowed values: PDF/A-1b, PDF/A-2b, PDF/A-3b. |
| paper | ENUM | No | Paper size. Allowed values: A3, A4 (default), A5, A6, Letter, Legal, Tabloid. |
| landscape | Boolean | No | Landscape pages. Default: false. |
| margin_top | Number | No | Top margin in inches. Range: 0-4. Default: 0.39. |
| wait_delay | Integer | No | Seconds to wait after the page loads for JavaScript-heavy pages. Range: 0-10. |
| footer_html | String | No | HTML repeated at the bottom of every page; uses the same placeholders as header_html. |
| header_html | String | No | HTML repeated at the top of every page. <span class="pageNumber"></span> and <span class="totalPages"></span> are filled in. |
| margin_left | Number | No | Left margin in inches. Range: 0-4. Default: 0.39. |
| margin_right | Number | No | Right margin in inches. Range: 0-4. Default: 0.39. |
| margin_bottom | Number | No | Bottom margin in inches. Range: 0-4. Default: 0.39. |
| print_background | Boolean | No | Print background colours and images. Default: true. |
Response
Returns a binary response containing the generated PDF document. The output schema is a binary string, so the success response is the PDF file itself rather than a JSON object.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| binary | String | Yes | PDF file content returned as binary data. |



