canonical: https://jentic.com/apis/pdfmyurl.com/pdfmyurl

# PDFmyURL API

Jentic publishes the only available OpenAPI specification for PDFmyURL API, keeping it validated and agent-ready. PDFmyURL API converts any URL or raw HTML to high-quality PDF documents with extensive customization options. The service supports configurable page layouts, custom headers and footers, watermarks, password encryption, and page numbering. It handles both GET and POST requests to its /api endpoint, making it suitable for both simple URL conversions and complex document generation with multiple options.

## For AI agents

Convert any URL or raw HTML to PDF with options for layout, watermarks, headers, footers, and encryption. Handles both simple and complex PDF conversion needs.

## Scope

Does not handle template-based generation, batch processing queues, or document storage - use for direct URL/HTML to PDF conversion only.

## Capabilities

- Convert any public URL to a PDF document with full CSS rendering
- Transform raw HTML content into formatted PDF output
- Apply custom headers, footers, and page numbers to generated PDFs
- Add text or image watermarks to PDF output
- Encrypt generated PDFs with password protection
- Configure page size, orientation, and margins per conversion

## Use cases

### Branded Document Export

Convert web-based reports or dashboards to branded PDFs with custom headers containing company logos, footers with page numbers, and specific page sizes matching corporate standards. PDFmyURL handles all rendering including CSS, images, and JavaScript-rendered content, producing print-ready documents from any URL.

Example prompt: POST to /api with the target URL, custom header HTML with logo, footer with page numbering, and A4 page size to generate a branded PDF

### Secure Document Distribution

Generate password-encrypted PDFs from web content for secure document distribution. PDFmyURL applies PDF encryption with user and owner passwords, restricting printing, copying, or editing of the generated document. This is suitable for distributing confidential reports, contracts, or financial documents.

Example prompt: POST to /api with the document URL and encryption parameters including user password and permission restrictions to produce a secured PDF

### Watermarked Proof Generation

Create watermarked PDF proofs from web content for review workflows. Apply text watermarks like DRAFT or CONFIDENTIAL, or image watermarks with logos, to PDFs generated from URLs. This enables review distribution without risking unauthorized use of final content.

Example prompt: POST to /api with the content URL and a diagonal text watermark reading DRAFT to generate a watermarked proof PDF

### AI Agent PDF Conversion via Jentic

AI agents convert web content to PDF as part of automated workflows by calling PDFmyURL through Jentic. The agent searches for URL-to-PDF operations, receives the /api schema with all available options, and executes conversions with headers, watermarks, or encryption as needed without manual API key management.

Example prompt: Search Jentic for 'convert URL to PDF with watermark', load the /api operation schema, and execute with target URL and watermark options

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /api | Convert a URL to PDF via query parameters |
| POST | /api | Convert URL or HTML to PDF with full options |

## Key resources

- **API Conversion** — Convert URLs or HTML to PDF with layout, watermark, encryption, and header/footer options

## Why Jentic

- **Setup:** Wiring PDFmyURL by hand means passing your license as a query parameter on every request, building the multipart POST for raw HTML, and handling the many layout, watermark, and encryption options yourself. Through Jentic you install once, import the PDFmyURL API from the API Directory, store the license key once, and your agent calls it.
- **Permission scoping:** PDFmyURL exposes a single /api endpoint reached by GET or POST, so scoping is operations-only: limit the agent to the operations it needs, such as converting a URL to PDF, and leave anything else out of the allowed set. You choose which operations it may call so nothing beyond that runs.
- **Credential handling:** Your PDFmyURL license key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'convert a URL to PDF with a watermark', and Jentic returns the matching PDFmyURL operation with its input schema covering layout, watermark, and encryption options so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **PDF Endpoint API** — Simple HTML/URL to PDF conversion with fewer options
- **HTML2PDF API** — HTML-to-PDF conversion with different rendering options
- **SelectPdf API** — URL-to-PDF with rendering accuracy focus

## FAQ

### Why is there no official OpenAPI spec for PDFmyURL API?

PDFmyURL does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call PDFmyURL API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the PDFmyURL API use?

PDFmyURL API uses a license key passed as a query parameter named 'license'. You receive this key when subscribing to a PDFmyURL plan. Through Jentic, the license key is stored encrypted in the vault and injected into requests automatically.

### Can I add watermarks to PDFs generated from URLs?

Yes. The /api endpoint accepts watermark parameters for both text and image watermarks. You can specify text content, position, rotation angle, opacity, and font size for text watermarks, or provide an image URL for image-based watermarks.

### Can I encrypt PDFs with a password using this API?

Yes. The /api endpoint supports PDF encryption options including user password (required to open the PDF) and owner password (controls permissions). You can restrict printing, text copying, and content modification on the generated document.

### How do I convert URLs to PDF through Jentic?

Install with pip install jentic, search for 'convert URL to PDF', and Jentic returns the /api operation schema with all conversion options. Execute with the target URL and any options like headers, watermarks, or encryption. Jentic injects the license key automatically.

### Does PDFmyURL support custom page sizes and orientations?

Yes. The /api endpoint accepts parameters for page size (A4, Letter, Legal, and custom dimensions), orientation (portrait or landscape), and margins (top, bottom, left, right). These can be set per conversion request.

### Can I limit what my agent is allowed to do with the PDFmyURL API?

Yes. Because you run Jentic One yourself, your own rules decide which PDFmyURL operations and credentials your agent can use. The PDFmyURL API exposes a single /api endpoint reached by GET or POST, so scoping is operations-only: you allow just the conversion operation your agent needs, such as converting a URL or HTML to PDF, and leave everything else out of the allowed set. Anything you do not permit never runs, and your license key stays with your instance rather than the agent.