Blog Post

How to Delete PDF Pages Using Python

Vyom Srivastava
Illustration: How to Delete PDF Pages Using Python

In this post, you’ll learn how to delete PDF pages using our Delete PDF Page Python API. With our API, you can process up to 100 PDF files per month for free. You’ll just need to create a free account to access your API key.

This post will be especially helpful for developers working with Python in document-heavy workflows who need to programmatically remove pages from a PDF to delete confidential data, save storage space, or remove information that’s unnecessary for end users.


Deleting PDF pages is just one of the operations possible with our 30+ PDF API tools. You can combine our deletion tool with other tools to create complex document processing workflows, such as:

  • Converting MS Office files and images into PDFs before removing pages

  • Removing pages from two documents before merging them

  • Deleting pages and then watermarking and flattening PDFs

Once you create your account, you’ll be able to access all our PDF API tools.

Getting Started

To get started, you’ll need to:

  • Create a free account to access your live API key.

  • Install Python on your system. You can download Python here.

Step 1 — Creating a Free Account on PSPDFKit

Go to our website, where you’ll see the page below, prompting you to create your free account.

Free account PSPDFKit API

Once you’ve created your account, you’ll be welcomed by the page below, which shows an overview of your plan details.

Free plan PSPDFKit API

As you can see in the bottom-left corner, you’ll start with 100 documents to process, and you’ll be able to access all our PDF API tools.

Step 2 — Obtaining the API Key

After you’ve verified your email, you can get your API key from the dashboard. In the menu on the left, click API Keys. You’ll see the following page, which is an overview of your keys:

Delete PDF Pages Python API Key

Copy the Live API Key, because you’ll need this for the Delete PDF Page API.

Step 3 — Setting Up Folders and Files

Now, create a folder called delete_pdf and open it in a code editor. For this tutorial, you’ll use VS Code as your primary code editor. Next, create two folders inside delete_pdf and name them input_documents and processed_documents.

Then, in the root folder, delete_pdf, create a file called This is the file where you’ll keep your code.

Now your folder structure will look like this:

├── input_documents
├── processed_documents

Step 4 — Writing the Code

Open the file and paste the code below into it:

import requests
import json

instructions = {
  'parts': [
      'file': 'document',
      'pages': {
        'end': 2
      'file': 'document',
      'pages': {
        'start': 4

response = requests.request(
  headers = {
    'Authorization': 'Bearer YOUR_API_KEY_HERE’
  files = {
    'document': open('input_documents/document.pdf', 'rb')
  data = {
    'instructions': json.dumps(instructions)
  stream = True

if response.ok:
  with open('processed_documents/result.pdf', 'wb') as fd:
    for chunk in response.iter_content(chunk_size=8096):

ℹ️ Note: Make sure to replace YOUR_API_KEY_HERE with your API key.

Code Explanation

In the code above, you first import the requests and json dependencies. After that, you create the instructions for the API call. In this case, you delete page 4.

You then use the requests module to make the API call, and once it succeeds, you store the result in the processed_documents folder.


To execute the code, use the command below:


Once the code has been executed, you’ll see a new processed file under the processed_documents folder called result.pdf.

The folder structure will look like this:

├── input_documents
|    └── document.pdf
├── processed_documents
|    └── result.pdf

Final Words

In this post, you learned how to easily and automatically delete pages from a PDF document for your Python application using our Delete PDF Page API.

You can integrate these functions into your existing applications to remove pages from PDFs. With the same API token, you can also perform other operations, such as merging documents into a single PDF, adding watermarks, and more. To get started with a free trial, sign up here.

Related Products

Product Page

Share Post
Free 60-Day Trial Try PSPDFKit in your app today.
Free Trial

Related Articles

Explore more

How to OCR PDFs with PSPDFKit API

TUTORIALS  |  Python • API • OCR

How to Extract Text from PDF in Python

TUTORIALS  |  API • Python • How To • Tesseract • OCR

How to Use Tesseract OCR in Python