uphunt

Official UpHunt SDK for Python — auto-apply to Upwork jobs, fetch archived job & client data, and generate AI proposals, all from your own stack.

• 📚 Full API docs: https://uphunt.io/docs
• 🔑 Get an API key: Dashboard → Auto-Apply → API & Webhooks

Install

pip install uphunt

Requires Python 3.9+.

Quickstart

from uphunt import UpHunt

client = UpHunt(api_key="...")  # or set UPHUNT_API_KEY in the environment

# Apply to a job
result = client.apply(
    job_id="~022053140178050136031",
    cover_letter="Hi — I'd love to help with this project…",
    proposal={"hourlyRate": 65, "timeline": "1 to 3 months"},
)
print(result["queueId"])

# Poll status
status = client.status(queue_id=result["queueId"])
print(status["applicationStatus"])  # 'processing' | 'applied' | …

Use it as a context manager to close the connection pool automatically:

with UpHunt() as client:
    jobs = client.applied_jobs(limit=10, status="applied")

Methods

Error handling

Any non-2xx response raises UpHuntError with .status_code and .body:

from uphunt import UpHunt, UpHuntError

try:
    client.apply(job_id="~01abc", cover_letter="…")
except UpHuntError as err:
    print(err.status_code, err, err.body)

Generate a proposal, then apply

gen = client.generate_proposal(job_id="~01abc", reasoning_effort="medium")
client.apply(job_id="~01abc", cover_letter=gen["proposal"])

License

MIT © UpHunt