https://api.pdf-image.net/convertALL requests to this API MUST include a valid API key as a query parameter.
Without an API key, requests will be rejected with a 401 Unauthorized error.
?api_key=pk_live_abc123...def789Generate your free API key below with one click. Start with 3 free conversions!
Converts a PDF accessible via a URL into one or more images. Returns a single image if the PDF has only one page, or a ZIP file if it contains multiple pages. Requires API key authentication.
GET https://api.pdf-image.net/convertThis endpoint allows you to download a PDF from a URL, convert its pages to images in various formats (png, jpg, jpeg, webp, tiff), and return the result as either a single image or a ZIP file containing multiple images.
| Name | Type | Required | Description |
|---|---|---|---|
api_key | Query String | REQUIRED | Your API key - MANDATORY for all requests Format: pk_live_abc123...def789 |
url | string | Required | URL of the PDF file to download |
format | string | Optional | Output image format. Valid values: png, jpg, jpeg, webp, tiff. Default: png |
output | string | Optional | Output type. Valid values: image or zip. Default: image |
quality | integer | Optional | Quality/compression. Range: 1 to 100. Default: 90 |
⚠️ If the PDF has more than one page and output=image, an error will be returned.
This ensures that all pages are properly converted and can be downloaded in a single response.
If you're building an API and don't know whether the PDF will have one or multiple pages, always use output=zip. This way you don't need to duplicate logic in your code to handle both single images and ZIP files - you'll always receive a ZIP file that you can process consistently.
GET https://api.pdf-image.net/convert?api_key=pk_live_abc123...def789&url=https://example.com/file.pdf&format=png&output=imageGET https://api.pdf-image.net/convert?api_key=pk_live_abc123...def789&url=https://example.com/file.pdf&format=jpg&output=zipGET https://api.pdf-image.net/convert?api_key=pk_live_abc123...def789&url=https://example.com/file.pdf&format=webp&quality=80| Code | Description |
|---|---|
400 | The PDF could not be downloaded or parameters are invalid |
400 | If output is image and the PDF has more than one page |
500 | Internal server error (issues converting or saving images) |