Transformer API Python SDK

Official Python client for the Transformer API — career-graph extraction, job matching, and career intelligence over raw text, with real provenance on every derived fact.

Install

pip install careerstudiomax-transformer

Quickstart

from transformer import TransformerClient

client = TransformerClient(api_key="csk_live_your_key_here")

result = client.extract("Led backend team at Acme, hired by a recruiter for a Senior Engineer role, $145k")
print(result["data"]["entities"])

What you can do

Example: career graph + webhook tracking

graph = client.career_graph(text=resume_text, candidate_id="cand-123")
print(graph["data"]["careerScore"])

Webhooks (account access token, not an API key)

hook = client.create_webhook(
    "https://your-app.example.com/hooks/transformer",
    access_token="your_account_access_token",
    candidate_id="cand-123",
)
print(hook["secret"])  # shown once

Errors

from transformer import TransformerClient, TransformerError

try:
    client.job_match("...", candidate_text="...")
except TransformerError as e:
    print(e.status, str(e))

Context manager

with TransformerClient(api_key="...") as client:
    ...

Full endpoint reference: transformer.careerstudiomax.com/docs