Page Extractor
API Documentation

Overview

The Page Extractor API works in two stages. First, analyze an uploaded PDF to learn its page count, size, and type. Then, extract the pages you need — all pages, a single page, a range like 1-3, or a list like 1,3,5. Extracted pages are returned as individual PDF files (bundled into a ZIP when multiple) or as one combined PDF, ready for download. Perfect for splitting documents, pulling specific sections, or rearranging PDF content.

Base URL & Authentication

Base URL

https://api.chemhub.com

Authentication

All Page Extractor endpoints require an authenticated session. The endpoints are exposed under the /api-hub/page-extractor/ prefix on the application and rely on your logged-in account session cookie.

Endpoints

Analyze File

Upload a PDF file to inspect its page count, file type, and size before extraction. Upload the file as multipart/form-data.

Form Parameters

Response

{
  "success": true,
  "filename": "document.pdf",
  "size_mb": 4.3,
  "file_type": "PDF",
  "analysis": {
    "pages": 12
  }
}

Code Examples

import requests

url = "https://api.chemhub.com/api-hub/page-extractor/analyze"

# Use a requests.Session to keep your login cookies
session = requests.Session()

with open("document.pdf", "rb") as f:
    files = {"file": f}
    res = session.post(url, files=files)

print(res.json())

curl -X POST "https://api.chemhub.com/api-hub/page-extractor/analyze" \
  -b "session=<your_session_cookie>" \
  -F "file=@document.pdf"

const form = new FormData();
form.append('file', fileInput.files[0]);

fetch('https://api.chemhub.com/api-hub/page-extractor/analyze', {
  method: 'POST',
  credentials: 'include',
  body: form
})
.then(res => res.json())
.then(console.log);

Extract Pages

Extract selected pages from a previously analyzed PDF. Send a JSON body referencing the analyzed filename.

JSON Parameters

Response

{
  "success": true,
  "extracted_files": ["extracted_page_0001.pdf", "extracted_page_0002.pdf"],
  "job_id": "3f9a1c2b"
}

Code Examples

import requests

url = "https://api.chemhub.com/api-hub/page-extractor/extract"

session = requests.Session()

payload = {
    "filename": "document.pdf",
    "pages": "1-3",
    "format": "pdf"
}

res = session.post(url, json=payload)
print(res.json())

curl -X POST "https://api.chemhub.com/api-hub/page-extractor/extract" \
  -b "session=<your_session_cookie>" \
  -H "Content-Type: application/json" \
  -d '{"filename":"document.pdf","pages":"1-3","format":"pdf"}'

fetch('https://api.chemhub.com/api-hub/page-extractor/extract', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    filename: 'document.pdf',
    pages: '1-3',
    format: 'pdf'
  })
})
.then(res => res.json())
.then(console.log);

Download Result

Download an extracted result file. Use the filenames returned by the /extract endpoint.

Path Parameter

cURL Example

curl -b "session=<your_session_cookie>" \
  "https://api.chemhub.com/api-hub/page-extractor/download/extracted_page_0001.pdf" \
  --output extracted_page_0001.pdf

Page Specifications

The pages parameter accepts several formats:

Python SDK

Complete Python SDK covering the full analyze → extract → download workflow.

import requests

BASE_URL = "https://api.chemhub.com"
session = requests.Session()

# --- Analyze a PDF file ---
def analyze_pdf(pdf_path):
    with open(pdf_path, "rb") as f:
        files = {"file": f}
        res = session.post(f"{BASE_URL}/api-hub/page-extractor/analyze", files=files)
    data = res.json()
    if data.get("success"):
        print(f"Analyzed {data['filename']}: {data['analysis']['pages']} pages")
    return data

# --- Extract pages ---
def extract_pages(filename, pages="all", output_format="pdf"):
    payload = {
        "filename": filename,
        "pages": pages,
        "format": output_format
    }
    res = session.post(f"{BASE_URL}/api-hub/page-extractor/extract", json=payload)
    return res.json()

# --- Download a result file ---
def download_result(result_filename, save_path):
    res = session.get(
        f"{BASE_URL}/api-hub/page-extractor/download/{result_filename}"
    )
    if res.status_code == 200:
        with open(save_path, "wb") as f:
            f.write(res.content)
        print(f"Downloaded to: {save_path}")
        return True
    print(f"Download failed: {res.status_code}")
    return False

# --- Full workflow ---
if __name__ == "__main__":
    print("=== PAGE EXTRACTOR API TEST ===")

    analysis = analyze_pdf("document.pdf")
    if not analysis.get("success"):
        raise SystemExit("Analysis failed")

    result = extract_pages(analysis["filename"], pages="1-3", output_format="pdf")
    print(f"Extraction result: {result}")

    for file in result.get("extracted_files", []):
        download_result(file, file)

Errors & Status Codes

Error Response Format

{
  "error": "Only PDF files are supported. Please upload a PDF file."
}

Status Codes

Limitations