Extract pages from a PDF

Use this action to extract one or more pages from a PDF document.


POST https://api.pdfblocks.com/v1/extract_pages

Global endpoint (default)

POST https://eu.api.pdfblocks.com/v1/extract_pages

European-only endpoint


The endpoint accepts multipart/form-data request bodies with the folowing parameters:

file Required

The content of the input PDF document.

first_page optional

Integer with the first page of the range to extract from the PDF document.

  • The minimum value is 1
  • Defaults to the first page of the PDF document.

last_page optional

Integer with the last page of the range to extract from the PDF document.

  • The minimum value is 1
  • Defaults to the last page of the PDF document.


If successful, the call returns a response with Content-Type: application/pdf with the content of the extracted PDF document. Otherwise, this call returns an error.

Code examples


curl \
-F file=@input.pdf \
-F first_page=2 \
-F last_page=4 \
-o extracted.pdf \
-H 'X-Api-Key: your_api_key' \


# pip install requests

import requests

url = 'https://api.pdfblocks.com/v1/extract_pages'

body = {
  'file' : open('input.pdf', 'rb'),
  # 'first_page' : 2,
  # 'last_page' : 4,

headers = { 'X-Api-Key' : 'your_api_key' }

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

if response.status_code == 200:
  with open('extracted_pages.pdf', 'wb') as output:
    for chunk in response.iter_content():


# gem install http

require 'http'

url = 'https://api.pdfblocks.com/v1/extract_pages'

body = {
  file: HTTP::FormData::File.new('input.pdf'),
  # first_page: 2,
  # last_page: 4,

headers = { 'X-Api-Key' => 'your_api_key' }

response = HTTP.post(url, form: body, headers: headers)

if response.status.ok?
  File.open('extracted_pages.pdf', 'wb') do |output|
    response.body.each { |chunk| output.write(chunk) }

C# (.NET Core)

// Using .NET Core 3.1

using System.IO;
using System.Net.Http;

class Program
    static void Main()
        string url = "https://api.pdfblocks.com/v1/extract_pages";

        var inputFile = new FileStream("input.pdf", FileMode.Open, FileAccess.Read);

        var body = new MultipartFormDataContent();
        body.Add(new StreamContent(inputFile), "file");
        // body.Add(new StringContent("2"), "first_page");
        // body.Add(new StringContent("4"), "last_page");

        var message = new HttpRequestMessage(HttpMethod.Post, url);
        message.Content = body;
        message.Headers.Add("X-Api-Key", "your_api_key");

        var client = new HttpClient();
        var response = client.SendAsync(message).Result;
            using var output = new FileStream("extracted.pdf", FileMode.Create, FileAccess.Write);