Skip to content

Getting started

This guide walks through a Cloud-first setup for pdfrest (the Python package published on PyPI) so you can make your first API call quickly.

Before you begin

  • A Python runtime (3.10+ recommended for this SDK).
  • A local PDF file to test with.
  • A pdfRest Cloud account and API key.

For the official Cloud onboarding flow, see:

1. Create a project and install pdfrest

mkdir pdfrest-quickstart
cd pdfrest-quickstart
uv init
uv add pdfrest

mkdir pdfrest-quickstart
cd pdfrest-quickstart
python -m venv .venv
source .venv/bin/activate
pip install pdfrest

mkdir pdfrest-quickstart
cd pdfrest-quickstart
poetry init --no-interaction
poetry add pdfrest

2. Get your pdfRest Cloud API key

  1. Create or sign in to your account at pdfRest.com.
  2. Follow the Cloud onboarding steps in Getting Started.
  3. Copy your API key and export it as PDFREST_API_KEY in your shell.
export PDFREST_API_KEY="your-api-key-here"

$env:PDFREST_API_KEY="your-api-key-here"

Tip

The API Lab is useful for testing endpoints interactively and generating starter code samples before integrating them into your project.

3. Add a short example program

Create quickstart.py:

from pathlib import Path

from pdfrest import PdfRestClient

input_pdf = Path("input.pdf")

if not input_pdf.exists():
    raise FileNotFoundError(
        "Place a test PDF at ./input.pdf before running this script."
    )

with PdfRestClient() as client:
    uploaded = client.files.create_from_paths([input_pdf])[0]
    document = client.extract_pdf_text(uploaded, full_text="document")

full_text = ""
if document.full_text is not None and document.full_text.document_text is not None:
    full_text = document.full_text.document_text

print(f"Input file id: {uploaded.id}")
print("Extracted text preview:")
print(full_text[:500] if full_text else "(no text returned)")

What this script does:

  • Uploads input.pdf to pdfRest Cloud.
  • Calls extract_pdf_text.
  • Prints a short text preview from the response.

4. Run the example

uv run python quickstart.py

python quickstart.py

poetry run python quickstart.py

5. Next steps