EmuPDF — APIs

Merge PDFs API

Combine multiple PDF files into a single document instantly.

Endpoint

POST /api/v1/merge/

Authentication

X-API-Key: YOUR_API_KEY

Request

Send PDF files using multipart/form-data.

files: PDF file(s)

Python Example


    import requests

    url = "https://emupdf.com/api/v1/merge/"

    files = [
        ("files", open("file1.pdf", "rb")),
        ("files", open("file2.pdf", "rb")),
    ]

    headers = {
        "X-API-Key": "YOUR_API_KEY"
    }

    response = requests.post(
        url,
        headers=headers,
        files=files
    )
    content_type = response.headers.get("Content-Type","")
    print("Status:",response.status_code)
    print("Content-Type:",content_type)

JavaScript Example (Browser)


  async function mergePDFs(files) {
        const formData = new FormData();
        for (let i = 0; i < files.length; i++) {
            formData.append("files", files[i]);
        }

        const response = await fetch("https://emupdf.com/api/v1/merge/", {
            method: "POST",
            headers: {
                "X-API-Key": "YOUR_API_KEY"
            },
            body: formData
        });

        if (!response.ok) {
            const error = await response.text();
            console.error("Error:", error);
            return;
        }

        // Convert response to blob (PDF file)
        const blob = await response.blob();

        // Create download link
        const url = window.URL.createObjectURL(blob);

        const a = document.createElement("a");
        a.href = url;
        a.download = "merged.pdf";
        document.body.appendChild(a);
        a.click();

        a.remove();
        window.URL.revokeObjectURL(url);
   }

Response

  Status: 200
  Content-Type: application/pdf

Errors

  401 → Invalid API Key
  400 → Invalid file upload
  500 → Server error

Split PDF API

Extract a specific page range from a PDF and download it as a new PDF.

Endpoint

POST /api/v1/split/

Authentication

X-API-Key: YOUR_API_KEY

Request

Send a PDF file and specify the page range to extract.

file: PDF file start_page: Integer end_page: Integer

Python Example


import requests

url = "https://emupdf.com/api/v1/split/"

files = {
    "file": open("document.pdf", "rb")
}

data = {
    "start_page": 1,
    "end_page": 5
}

headers = {
    "X-API-Key": "YOUR_API_KEY"
}

response = requests.post(url,headers=headers,files=files,data=data)
content_type = response.headers.get("Content-Type","")

print("Status:", response.status_code)
print("Content-Type:", content_type)

if response.status_code == 200:
    with open("document_pages_1-5.pdf","wb") as f:
        f.write(response.content)

JavaScript Example (Browser)


async function splitPDF(file,startPage,endPage) {
    const formData = new FormData();
    formData.append("file",file);
    formData.append("start_page",startPage);

    formData.append("end_page",endPage);

    const response = await fetch(
        "https://emupdf.com/api/v1/split/",
        {
            method: "POST",
            headers: {
                "X-API-Key":"YOUR_API_KEY"
            },
            body: formData
        }
    );

    if (!response.ok) {

        const error = await response.text();
        console.error("Error:",error);
        return;
    }

    const blob = await response.blob();
    const url =window.URL.createObjectURL(blob);

    const a =document.createElement("a");

    a.href = url;
    a.download = "split.pdf";
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

Example Request

file: document.pdf
start_page: 10
end_page: 25

Response

Status: 200
Content-Type: application/pdf

Returned file:
document_pages_10-25.pdf

Validation Rules

start_page >= 1

end_page <= total pages

start_page <= end_page

Errors

401 → Invalid API Key

400 → No PDF uploaded

400 → Invalid PDF

400 → Invalid page range

400 → Encrypted PDF

500 → Server error

Unlock PDF API

Remove password protection from an encrypted PDF using the correct password.

Endpoint

POST /api/v1/unlock/

Authentication

X-API-Key: YOUR_API_KEY

Request

Send an encrypted PDF and the password used to open it.

file: PDF file password: PDF password

Python Example


import requests

url = "https://emupdf.com/api/v1/unlock/"

files = {
    "file": open(
        "protected.pdf",
        "rb"
    )
}

data = {
    "password": "mypassword"
}

headers = {
    "X-API-Key": "YOUR_API_KEY"
}

response = requests.post(url,headers=headers,files=files,data=data)

content_type = response.headers.get("Content-Type","")

print("Status:",response.status_code)

print("Content-Type:",content_type)

if response.status_code == 200:

    with open("unlocked.pdf","wb") as f:
        f.write(response.content)

JavaScript Example (Browser)


async function unlockPDF(file,password) {
    const formData =new FormData();
    formData.append("file",file);
    formData.append("password",password);

    const response =
        await fetch("https://emupdf.com/api/v1/unlock/",{
                method: "POST",
                headers: {
                    "X-API-Key":"YOUR_API_KEY"
                },
                body: formData
            }
        );

    if (!response.ok) {

        const error = await response.text();
        console.error("Error:",error);
        return;
    }

    const blob =await response.blob();
    const url =window.URL.createObjectURL(blob);

    const a =document.createElement("a");
    a.href = url;
    a.download ="unlocked.pdf";
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

Example Request

file: protected.pdf
password: mypassword

Response

Status: 200
Content-Type: application/pdf

Returned file:
protected_unlocked.pdf

Validation Rules

PDF must be encrypted

Password is required

Password must be correct

Errors

401 → Invalid API Key

400 → No PDF uploaded

400 → Password is required

400 → Invalid PDF

400 → Invalid PDF password

400 → PDF is not password protected

500 → Server error

Compress PDF

Coming soon.

Developer Dashboard

EmuPDF API

Merge PDFs API

Endpoint

Authentication

Request

Python Example

JavaScript Example (Browser)

Response

Errors

Split PDF API

Endpoint

Authentication

Request

Python Example

JavaScript Example (Browser)

Example Request

Response

Validation Rules

Errors

Unlock PDF API

Endpoint

Authentication

Request

Python Example

JavaScript Example (Browser)

Example Request

Response

Validation Rules

Errors

Compress PDF

All PDF Tools

Merge PDF

Split PDF

Unlock PDF

Encrypt PDF

Edit PDF

Delete Pages

Compress PDF

PDF → Word

Images → PDF