pdftables-io

Official Python SDK for the pdftables.io API — extract tables from PDFs programmatically.

pip install pdftables-io

Quick Start

from pdftables import PDFTablesClient

client = PDFTablesClient(api_key="your-api-key")

# 1. Upload a PDF
upload = client.upload("invoice.pdf")

# 2. Start table extraction
job = client.create_job(upload.upload_id)

# 3. Wait for completion
job = client.wait_for_job(job.id)

# 4. Download results as CSV
csv_zip = client.download_job_csv(job.id)
with open("tables.zip", "wb") as f:
    f.write(csv_zip)

Authentication

Pass your API key directly or set the PDFTABLES_API_KEY environment variable:

# Explicit
client = PDFTablesClient(api_key="sk_live_...")

# Via environment variable
# export PDFTABLES_API_KEY=sk_live_...
client = PDFTablesClient()

Async Usage

import asyncio
from pdftables import AsyncPDFTablesClient

async def main():
    async with AsyncPDFTablesClient(api_key="your-api-key") as client:
        upload = await client.upload("invoice.pdf")
        job = await client.create_job(upload.upload_id)
        job = await client.wait_for_job(job.id)
        csv_zip = await client.download_job_csv(job.id)

asyncio.run(main())

API Reference

Upload

Extraction Jobs

Downloads

Export Structures

DATEV

Error Handling

from pdftables import PDFTablesClient, AuthenticationError, RateLimitError

client = PDFTablesClient(api_key="your-key")

try:
    upload = client.upload("invoice.pdf")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Rate limit exceeded — try again later")

Advanced: Custom Base URL

client = PDFTablesClient(
    api_key="your-key",
    base_url="https://staging-api.pdftables.io",
    timeout=60.0,
)

Requirements

• Python ≥ 3.10
• httpx ≥ 0.27
• pydantic ≥ 2.0

License

BSD 3-Clause — see LICENSE.