PDF to Image API Reference

Convert PDF pages into high-quality images in PNG, JPG, TIFF, BMP, or GIF format.

POST

https://api.apifreaks.com/v1.0/pdf/jpg

The PDF to Image API converts PDF pages into image files in five supported formats. You can specify individual pages, ranges, or convert the entire document. Customize output with options like DPI, color mode, and image quality. Select a format above to see its specific endpoint and parameters.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl --location --request POST 'https://api.apifreaks.com/v1.0/pdf/jpg?apiKey=API-KEY&resolution=150&quality=85&profile=rgb&output=web_images' \
--header 'X-apiKey: API-KEY' \
--form 'file=@"/path/to/file.pdf"'

Response

{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "inputIds": [
    "7a9e4b12-f3c8-4d56-b7e1-8c2f9d0a3e6f"
  ]
}

API Request Parameters

All PDF to image endpoints accept the same common parameters with additional format-specific controls for color profiles and quality.

Best For: Photographs, small file sizes, general viewing

file_idoptionalString

The unique ID of a file already present on our server. Use PDF Files API to see your files. Check file metadata using File Status API

destroyoptionalBooleandefault: false

Set to true if you want to permanently delete the original file after processing.

pagesoptionalString

Pages to convert: comma-separated numbers/ranges (e.g., 1,3,2-5) or keywords.

1.Keywords: even (even pages) | odd (odd pages) | all (all pages) | last (use with pages: 5-last)
2.Note: Only "last" can combine with page numbers.

resolutionoptionalInteger

Set image sharpness in DPI (20-1200). Use 72-100 for web, 150-300 for printing.

image_smoothingoptionalString

Make images look smoother. Use 'none', 'all', or combine: 'text', 'line', 'image' with commas.

outputoptionalString

Optionally specify a custom name for the output file (without extension).

webhook_urloptionalString

Provide a URL to receive a webhook notification when the task is completed. The notification will include the task status and file ID(s) of the output.

webhook_failure_notificationoptionalBooleandefault: false

If true, we'll send an email notification if the webhook request fails after 3 retries. The email goes to the requesting user or their org admin if user is part of an organization.

profileoptionalString

Specifies the color profile for the output JPG images.

1.Acceptable values:
2. • gray – 8-bit grayscale.
3. • rgb – 24-bit RGB color (default).
4. • cmyk – 32-bit CMYK color, commonly used for print workflows.

qualityoptionalint

Controls JPG compression quality. Higher values yield sharper images with larger file sizes. Acceptable range: 1 to 100.

Request Headers

Optional custom headers for webhook authorization.

X-Webhook-AuthorizationoptionalString

Custom authorization header sent with the webhook request. Format: Key:Value (e.g., Authorization:Bearer token123).

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the task ID and input file IDs.

taskId

Stringmandatory

Unique identifier for the PDF task, used to check status.

inputIds

Array<String>optional

Array of file IDs referencing input files used for the task. Not returned when destroy=true.

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

Please provide either a file or a file ID.

400

Please provide a valid file ID

400

please pass correct parameters

400

Please provide a valid smoothing option or combination. Refer to the documentation for valid options.

415

The provided file type is not supported. Refer to the documentation for valid file types.