Python SDK

This SDK is currently in development and not yet published. The API surface described below is planned. Use the REST API directly in the meantime.

The official Python SDK for the Laddro Career API.

Installation

Package not yet published. Check back soon.

Quick Start


from laddro_career import LaddroClient
 
client = LaddroClient(api_key="YOUR_API_KEY")
 
# List templates
templates = client.templates.list()
 
# Parse a resume
with open("resume.pdf", "rb") as f:
    resume = client.resumes.parse(f)
 
# Tailor for a job
result = client.tailor(
    resume_id=resume.id,
    job_description="Senior Backend Engineer at..."
)

Configuration


client = LaddroClient(
    api_key="YOUR_API_KEY",
    base_url="https://api.laddro.com",  # default
    timeout=30.0                         # 30s default
)

Templates


templates = client.templates.list()
template = client.templates.get("graphite")

Resumes


# List
resumes = client.resumes.list()
 
# Get
resume = client.resumes.get("res_abc123")
 
# Parse
with open("resume.pdf", "rb") as f:
    parsed = client.resumes.parse(f)
 
# Render to PDF
pdf_bytes = client.resumes.render("res_abc123", template_id="graphite")
with open("resume.pdf", "wb") as f:
    f.write(pdf_bytes)

Tailoring


# Standard
result = client.tailor(
    resume_id="res_abc123",
    job_description="We are looking for..."
)
 
# Streaming
for event in client.tailor(
    resume_id="res_abc123",
    job_description="...",
    stream=True
):
    print(event.section, event.content)

Cover Letters


# Generate with streaming
for event in client.cover_letters.generate(
    resume_id="res_abc123",
    job_description="...",
    stream=True
):
    print(event.content, end="")
 
# Render to PDF
pdf_bytes = client.cover_letters.render("cl_abc123", template_id="graphite")

Export


pdf_bytes = client.export(
    resume_id="res_abc123",
    template_id="graphite"
)
with open("resume.pdf", "wb") as f:
    f.write(pdf_bytes)

Settings (BYOK)


settings = client.settings.get()
 
client.settings.set_model(
    provider="anthropic",
    model_id="claude-haiku-4.5",
    api_key="sk-ant-..."
)
 
client.settings.reset_model()

Error Handling


from laddro_career import LaddroError
 
try:
    client.resumes.get("nonexistent")
except LaddroError as e:
    print(e.status)   # 404
    print(e.message)  # "Resume not found"

Async Support


from laddro_career import AsyncLaddroClient
 
async_client = AsyncLaddroClient(api_key="YOUR_API_KEY")
 
templates = await async_client.templates.list()
 
async for event in async_client.tailor(
    resume_id="res_abc123",
    job_description="...",
    stream=True
):
    print(event.content)

Source

github.com/laddro-app/laddro-career-sdk-python