SearchCtrl+K

APIs/PDF Split & Extract Pages

PDF Split & Extract Page API

Our PDF Split and Extract Pages API enables you to divide PDF files into multiple documents or pull specific pages through simple REST endpoints. Whether you're splitting a hundred-page report into chapters, extracting key pages from contracts, or separating invoices into individual pages, our API handles it all while maintaining the original quality. Define custom page ranges, use special keywords like “even” or “odd”, or extract exactly the pages you need in a single request. The API preserves all fonts, images, formatting, and document structure without compression or quality loss.

Perfect for document management systems, invoice processing platforms, legal document automation, and content management solutions. Separate bulk scanned documents into individual files, extract signature pages from contracts, divide multi-page invoices for accounting systems, or pull specific chapters from reports. With asynchronous request processing and webhook support, you can seamlessly integrate PDF operations into your automation pipelines.

Try Playground Get Free API Key

10K Free Credits, No Credit Card Required

Features

Asynchronous Processing

Upon successful request, our API immediately returns a 200 OK response with a unique Task ID, processing your file in the background. You can track the task progress via our Task Status API using the unique Task ID.

Webhook Notifications

If you don't want to poll for task status, you can simply provide the webhook data in your request. Instead of manually checking status, we will automatically notify your endpoint the moment the task processing is completed.

Zero Data Retention

Your privacy matters. When you set the destroy parameter, your files are permanently wiped from our servers immediately after processing finishes, ensuring complete data security. If destroy is not set, files are retained up to 30 days based on user's plan.

Custom Page Splitting

Split documents exactly where you need. Define multiple custom page ranges (e.g., "1-5", "10-15") in a single request to generate specific sub-documents instantly. Each range creates its own PDF file from your source document.

Flexible Page Extraction

Extract only the pages you need from any PDF. Pull specific pages or ranges from a master file and save them as a new, clean PDF document. Perfect for creating subsets of large documents or isolating important sections.

Advanced Page Range Selection

Split PDFs or extract pages using individual numbers, ranges, or special keywords. Use "even" for even pages, "odd" for odd pages, "all" to split every page, or "last" to reference the final page. Mix page numbers and ranges in any order like "1-5,10,15-last" for complete control.

Split PDF into Individual Pages

Break PDF files into single pages effortlessly. Use the "all" keyword to split PDF into individual pages or extract custom page ranges as separate files. Perfect for processing bulk scanned documents or separating multi-page files.

Batch Page Processing

Extract multiple non-consecutive pages or different sections in a single API call. Process complex patterns like "1,5,10-15,20,25-last" efficiently without making multiple requests. Perfect for automated document workflows.

No Quality Loss

We keep your original document's quality. All things like fonts, pictures, and vector graphics, and the look do not change from original file. No compressing, downgrading, and you do not lose quality.

Large File Support

Handle heavy documents and high-resolution assets with ease. Our API supports a massive 1GB payload size per request, allowing you to process even the largest PDF files without worrying about size restrictions.

Free Web Tool

Need to quickly Extract Pages or Split PDF files in browser?

Extract specific pages or Split your PDF into separate files instantly.

Try Now

Split PDF API

API Endpoint

POSThttps://api.apifreaks.com/v1.0/pdf/split

Test

Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.

LANGUAGE


$ pip install requests
import requests

url = "https://api.apifreaks.com/v1.0/pdf/split?pages=1-5&output=split_document"

payload = {}
files=[
  ('file',('file.pdf',open('/path/to/file.pdf','rb'),'application/pdf'))
]
headers = {
  'X-apiKey': 'API-KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Extract Pages API

API Endpoint

POSThttps://api.apifreaks.com/v1.0/pdf/extract-pages

Test

Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.

LANGUAGE


$ pip install requests
import requests

url = "https://api.apifreaks.com/v1.0/pdf/extract-pages?pages=1%2C5%2C10-15&output=extracted_pages"

payload = {}
files=[
  ('file',('file.pdf',open('/path/to/file.pdf','rb'),'application/pdf'))
]
headers = {
  'X-apiKey': 'API-KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Utility & Resource APIs

Use these endpoints to manage files and check task status.

Task Status API

Check real-time status and retrieve input/output file ID(s) using the unique task_id. The response includes creation and expiry timestamps to help you track result availability, along with specific error details if a task fails. Results are retained for up to 7 days, depending on the operation.

Try Task Status API

File Status API

Retrieve detailed metadata for any file using its unique file_id. Returns details including file name, size, type, and creation/deletion timestamps. Generated or uploaded files are retained up to 30 days based on user's plan, unless destroy is enabled to delete them immediately. You can use this endpoint to check if the file has expired using its file_id.

Try File Status API

File Download API

Download any file from API Freaks server using its file ID. Works for both processed PDF files and ZIP archives containing multiple output files.

Try File Download API

PDF Delete API

Permanently delete a specific file you uploaded or generated using the file ID which you no longer need.

Try PDF Delete API

Files List API

Retrieve a list of all your PDF files stored on API Freaks server, with their file names and corresponding file IDs. Organization admins and maintainers can view all files in their organization, while members see only their own.

Try Files List API

File Upload API

Upload one or multiple PDF files in a single multipart/form-data request. Each file receives a unique file_id that can be used with the PDF APIs.

Try File Upload API

Upload Binary API

Upload a single large as a raw binary stream. This method eliminates multipart boundary overhead, offering faster upload speeds for larger files. Returns a unique file_id for uses with the PDF APIs.

Try Upload Binary API

How-To-Guides

Split PDF into Pages

Follow these steps to split PDF files using the API. The process involves uploading files, checking the task status, and downloading the result.

Step 1: Upload and Split PDF

Split PDFs into multiple documents by providing a file directly or referencing a file_id of a stored file. Define custom page ranges to break the PDF exactly where you need.

curl -X POST "https://api.apifreaks.com/v1.0/pdf/split?pages=1-5&pages=10-15&pages=20-last&output=split_document" \
  -H "X-apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

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

# Response with destroy=true (No File IDs as they are deleted right away)
{
    "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d"
}

Notes:

The API accepts only one PDF file per request (multipart file takes priority over file_id)
Use the Upload Binary API to significantly speed up large file uploads.
Multiple pages parameters create multiple output files
Each page range generates a separate PDF in the output
Use pages=all to split PDF into individual pages
Use the destroy=true parameter to delete input file after split completes (returns only taskId)
File IDs must reference valid, active files stored on the API Freaks server. You can verify if a file is still available using the File Status API

Step 2: Check Task Status

After submitting a split task, check its progress using the Task Status API with your taskId. The task goes through these statuses: queued, processing, completed, and failed.

curl -X GET "https://api.apifreaks.com/v1.0/pdf/task-status?task_id=04a06cd5-158d-4191-a45b-6f58249c599d" \
  -H "X-apikey: YOUR_API_KEY"

# Response (completed)
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "status": "completed",
  "createdAt": "2025-01-26 10:30:00",
  "outputUrls": [
    "https://api.apifreaks.com/v1.0/pdf/resource/download?resource_id=9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f"
  ],
  "outputFileId": [
    "9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f"
  ],
  "inputIds": [
    "7a9e4b12-f3c8-4d56-b7e1-8c2f9d0a3e6f"
  ],
  "expiresAt": "2025-01-27 10:30:00"
}

curl -X GET "https://api.apifreaks.com/v1.0/pdf/task-status?task_id=04a06cd5-158d-4191-a45b-6f58249c599d" \
  -H "X-apikey: YOUR_API_KEY"

# Response (failed)
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "status": "failed",
  "createdAt": "2025-01-26 10:30:00",
  "inputIds": [
    "7a9e4b12-f3c8-4d56-b7e1-8c2f9d0a3e6f"
  ],
  "error": "Invalid PDF File",
  "message": "The provided file is not a valid PDF file.",
  "expiresAt": "2025-01-27 10:30:00"
}

Step 3: Download Split PDFs

Once the task status shows “completed”, download your split PDFs using the File Download API with the outputFileId from the task status response. When multiple outputs are generated, the response includes multiple file IDs in the outputFileId array. Download each file separately using its respective ID.

curl -X GET "true?resource_id=9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f" \
  -H "X-apikey: YOUR_API_KEY" \
  --output split_document.pdf

Extract Pages from PDF

Extract specific pages from a PDF by providing a file directly or referencing a file_id of a stored file. Specify custom page ranges, individual page numbers, or special keywords for flexible extraction.

Step 1: Upload and Extract Pages

Upload your PDF and specify the pages to extract. After submitting, follow the same Step 2: Check Task Status and Step 3: Download Split PDFs described above to check task status and download your extracted pages.

curl -X POST "https://api.apifreaks.com/v1.0/pdf/extract-pages?pages=1,5,10-15,20&output=extracted_pages" \
  -H "X-apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

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

# Response with destroy=true (No File IDs as they are deleted right away)
{
    "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d"
}

Notes:

The API accepts only one PDF file per request (multipart file takes priority over file_id)
For faster uploads of large files, Upload Binary API can be used.
The pages parameter is required and defines which pages to extract.
When separated=false (default), all extracted pages are combined into one PDF and for separated=true, each page is saved as an individual PDF in a ZIP file.
Extract custom PDF page ranges using any combination of numbers and ranges.
Use the destroy=true parameter to delete input file after extraction completes (returns only taskId).
File IDs must reference valid, active files stored on the API Freaks server. You can verify if a file is still available using the File Status API.

Webhook Support

Get automatic notifications when your task completes instead of polling the task status endpoint. Good for event-driven applications and real-time document processing.

Add webhook_urlto your request. We'll send a POST request to this URL when the task finishes (either completed or failed).

See the Complete Webhook Example section below for a full demonstration including custom authorization headers.

Webhook Delivery

Webhook delivery will be attempted up to 3 times. If all retries fail and webhook_failure_notificationis enabled, we'll send an email notification to the requesting user or their organization admin.

Custom Authorization Header

Use X-Webhook-Authorization to add a custom header to webhook requests for endpoint security.

Format: Key:Value

Example: If you send Authorization:Bearer token123, the webhook request will include: Authorization: Bearer token123

See the Complete Webhook Example below for a full demonstration.

Complete Webhook Example

Here's a complete example showing webhook integration with custom authorization header and failure notifications:

curl -X 'POST' \
  'https://api.apifreaks.com/v1.0/pdf/split?webhook_url=https://yourdomain.com/webhook/pdf-split&webhook_failure_notification=true' \
  -H 'X-apiKey: YOUR_API_KEY' \
  -H 'X-Webhook-Authorization: Authorization:Bearer token123' \
  -F 'file=@/path/to/document.pdf'

# Response
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "inputIds": [
    "566dc743-d8fe-4943-8cef-61e5d3d6096c"
  ]
}

Webhook Request Format

When your task completes, we send a POST request to your webhook_url with these headers:

Header	Description
`Content-Type`	Always `application/json`
`X-Signature`	HMAC-SHA256 signature of the request body using your API key. Use this to verify the payload is authentic.
Custom Header	(If provided) Your custom header from `X-Webhook-Authorization`

Webhook Response

The webhook payload contains the same response structure as the Task Status API endpoint when checked for the task ID.

Verifying Webhook Authenticity

Use the X-Signatureheader to verify webhook requests actually came from API Freaks and weren't tampered with.

How the signature works:

We compute an HMAC-SHA256 hash of the request body using your API key as the secret
We Base64-encode the result
We send this as the X-Signature header value

To verify the webhook:

Take the raw payload body (JSON string exactly as received without parsing it)
Compute HMAC-SHA256 of the payload using your API key as the secret
Base64-encode the result of the hash
Compare with the X-Signature header value

Important:Don't transform or process the raw request body before verification. Adding whitespace or other formatting creates a different signature and verification will fail.

Pricing

To use this PDF Split & Extract Pages APIs, API credits are required. Charges apply only for successful queries, defined by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be refunded. In the event of a Task Processing Error, a maximum of 200 credits will be refunded. Surcharges for additional file sizes are non-refundable.

For each successful request, 200 credits will be charged. 1 extra credit will be charged per MB beyond 50 MB.

Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.

Price Estimation Calculator

APIs/PDF Split & Extract Pages

PDF Split & Extract Page API

Try Playground Get Free API Key

10K Free Credits, No Credit Card Required

Features

Asynchronous Processing

Webhook Notifications

Zero Data Retention

Custom Page Splitting

Flexible Page Extraction

Advanced Page Range Selection

Split PDF into Individual Pages

Batch Page Processing

No Quality Loss

Large File Support

Free Web Tool

Need to quickly Extract Pages or Split PDF files in browser?

Extract specific pages or Split your PDF into separate files instantly.

Try Now

Split PDF API

API Endpoint

POSThttps://api.apifreaks.com/v1.0/pdf/split

Test

Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.

LANGUAGE


$ pip install requests
import requests

url = "https://api.apifreaks.com/v1.0/pdf/split?pages=1-5&output=split_document"

payload = {}
files=[
  ('file',('file.pdf',open('/path/to/file.pdf','rb'),'application/pdf'))
]
headers = {
  'X-apiKey': 'API-KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Extract Pages API

API Endpoint

POSThttps://api.apifreaks.com/v1.0/pdf/extract-pages

Test

Explore the complete API reference with detailed request parameters, response fields, error codes, and code examples visit API Reference.

LANGUAGE


$ pip install requests
import requests

url = "https://api.apifreaks.com/v1.0/pdf/extract-pages?pages=1%2C5%2C10-15&output=extracted_pages"

payload = {}
files=[
  ('file',('file.pdf',open('/path/to/file.pdf','rb'),'application/pdf'))
]
headers = {
  'X-apiKey': 'API-KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Utility & Resource APIs

Use these endpoints to manage files and check task status.

Task Status API

Try Task Status API

File Status API

Try File Status API

File Download API

Download any file from API Freaks server using its file ID. Works for both processed PDF files and ZIP archives containing multiple output files.

Try File Download API

PDF Delete API

Permanently delete a specific file you uploaded or generated using the file ID which you no longer need.

Try PDF Delete API

Files List API

Try Files List API

File Upload API

Upload one or multiple PDF files in a single multipart/form-data request. Each file receives a unique file_id that can be used with the PDF APIs.

Try File Upload API

Upload Binary API

Try Upload Binary API

How-To-Guides

Split PDF into Pages

Follow these steps to split PDF files using the API. The process involves uploading files, checking the task status, and downloading the result.

Step 1: Upload and Split PDF

Split PDFs into multiple documents by providing a file directly or referencing a file_id of a stored file. Define custom page ranges to break the PDF exactly where you need.

curl -X POST "https://api.apifreaks.com/v1.0/pdf/split?pages=1-5&pages=10-15&pages=20-last&output=split_document" \
  -H "X-apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

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

# Response with destroy=true (No File IDs as they are deleted right away)
{
    "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d"
}

Notes:

The API accepts only one PDF file per request (multipart file takes priority over file_id)
Use the Upload Binary API to significantly speed up large file uploads.
Multiple pages parameters create multiple output files
Each page range generates a separate PDF in the output
Use pages=all to split PDF into individual pages
Use the destroy=true parameter to delete input file after split completes (returns only taskId)
File IDs must reference valid, active files stored on the API Freaks server. You can verify if a file is still available using the File Status API

Step 2: Check Task Status

After submitting a split task, check its progress using the Task Status API with your taskId. The task goes through these statuses: queued, processing, completed, and failed.

curl -X GET "https://api.apifreaks.com/v1.0/pdf/task-status?task_id=04a06cd5-158d-4191-a45b-6f58249c599d" \
  -H "X-apikey: YOUR_API_KEY"

# Response (completed)
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "status": "completed",
  "createdAt": "2025-01-26 10:30:00",
  "outputUrls": [
    "https://api.apifreaks.com/v1.0/pdf/resource/download?resource_id=9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f"
  ],
  "outputFileId": [
    "9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f"
  ],
  "inputIds": [
    "7a9e4b12-f3c8-4d56-b7e1-8c2f9d0a3e6f"
  ],
  "expiresAt": "2025-01-27 10:30:00"
}

curl -X GET "https://api.apifreaks.com/v1.0/pdf/task-status?task_id=04a06cd5-158d-4191-a45b-6f58249c599d" \
  -H "X-apikey: YOUR_API_KEY"

# Response (failed)
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "status": "failed",
  "createdAt": "2025-01-26 10:30:00",
  "inputIds": [
    "7a9e4b12-f3c8-4d56-b7e1-8c2f9d0a3e6f"
  ],
  "error": "Invalid PDF File",
  "message": "The provided file is not a valid PDF file.",
  "expiresAt": "2025-01-27 10:30:00"
}

Step 3: Download Split PDFs

curl -X GET "true?resource_id=9b2e7f3a-5c8d-4e1b-a6f9-0d3c8e7b2a5f" \
  -H "X-apikey: YOUR_API_KEY" \
  --output split_document.pdf

Extract Pages from PDF

Step 1: Upload and Extract Pages

curl -X POST "https://api.apifreaks.com/v1.0/pdf/extract-pages?pages=1,5,10-15,20&output=extracted_pages" \
  -H "X-apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

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

# Response with destroy=true (No File IDs as they are deleted right away)
{
    "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d"
}

Notes:

The API accepts only one PDF file per request (multipart file takes priority over file_id)
For faster uploads of large files, Upload Binary API can be used.
The pages parameter is required and defines which pages to extract.
When separated=false (default), all extracted pages are combined into one PDF and for separated=true, each page is saved as an individual PDF in a ZIP file.
Extract custom PDF page ranges using any combination of numbers and ranges.
Use the destroy=true parameter to delete input file after extraction completes (returns only taskId).
File IDs must reference valid, active files stored on the API Freaks server. You can verify if a file is still available using the File Status API.

Webhook Support

Get automatic notifications when your task completes instead of polling the task status endpoint. Good for event-driven applications and real-time document processing.

Add webhook_urlto your request. We'll send a POST request to this URL when the task finishes (either completed or failed).

See the Complete Webhook Example section below for a full demonstration including custom authorization headers.

Webhook Delivery

Custom Authorization Header

Use X-Webhook-Authorization to add a custom header to webhook requests for endpoint security.

Format: Key:Value

Example: If you send Authorization:Bearer token123, the webhook request will include: Authorization: Bearer token123

See the Complete Webhook Example below for a full demonstration.

Complete Webhook Example

Here's a complete example showing webhook integration with custom authorization header and failure notifications:

curl -X 'POST' \
  'https://api.apifreaks.com/v1.0/pdf/split?webhook_url=https://yourdomain.com/webhook/pdf-split&webhook_failure_notification=true' \
  -H 'X-apiKey: YOUR_API_KEY' \
  -H 'X-Webhook-Authorization: Authorization:Bearer token123' \
  -F 'file=@/path/to/document.pdf'

# Response
{
  "taskId": "04a06cd5-158d-4191-a45b-6f58249c599d",
  "inputIds": [
    "566dc743-d8fe-4943-8cef-61e5d3d6096c"
  ]
}

Webhook Request Format

When your task completes, we send a POST request to your webhook_url with these headers:

Header	Description
`Content-Type`	Always `application/json`
`X-Signature`	HMAC-SHA256 signature of the request body using your API key. Use this to verify the payload is authentic.
Custom Header	(If provided) Your custom header from `X-Webhook-Authorization`

Webhook Response

The webhook payload contains the same response structure as the Task Status API endpoint when checked for the task ID.

Verifying Webhook Authenticity

Use the X-Signatureheader to verify webhook requests actually came from API Freaks and weren't tampered with.

How the signature works:

We compute an HMAC-SHA256 hash of the request body using your API key as the secret
We Base64-encode the result
We send this as the X-Signature header value

To verify the webhook:

Take the raw payload body (JSON string exactly as received without parsing it)
Compute HMAC-SHA256 of the payload using your API key as the secret
Base64-encode the result of the hash
Compare with the X-Signature header value

Important:Don't transform or process the raw request body before verification. Adding whitespace or other formatting creates a different signature and verification will fail.

Pricing

For each successful request, 200 credits will be charged. 1 extra credit will be charged per MB beyond 50 MB.