Metadata-Version: 2.5
Name: worklittle
Version: 1.1.2
Summary: Official Worklittle Python SDK and CLI for job search on api.worklittle.com
Project-URL: Homepage, https://docs.worklittle.com/libraries/sdk#python
Project-URL: Documentation, https://docs.worklittle.com/libraries/overview
Author: Worklittle
License-Expression: MIT
Keywords: api,ats,cli,job search,jobs,sdk,worklittle
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# worklittle

Python SDK and CLI for [api.worklittle.com](https://api.worklittle.com).
Worklittle is the job search and hiring API for jobs, applications, and organizations.

Get started at [docs.worklittle.com](https://docs.worklittle.com/libraries/sdk#python)!

[Create a key on Business](https://worklittle.com/business/api-keys).

## Install

```bash
pip install worklittle
```

```python
from worklittle import Worklittle

wl = Worklittle()
jobs = wl.jobs.search(q="software engineer", limit=5)
filtered = wl.jobs.search(
    title="software engineer, -senior",
    company="-lucid-motors,-tesla",
    limit=5,
)
```

## CLI

```bash
export WORKLITTLE_API_KEY=sk-wl-api01-...
worklittle jobs search --q="software engineer" --limit 1 --pretty
worklittle jobs search --title="software engineer, -senior" --company="-lucid-motors,-tesla" --limit 5 --pretty
```

`--company` accepts bare slugs (include) or leading-dash slugs (exclude). Title negatives use `--title` / `--q`. Other `GET /jobs` flags pass through the same way (`--workplace_type`, `--posted_within_days`, …).

[Create a key on Business](https://worklittle.com/business/api-keys). Prefer `WORKLITTLE_API_KEY` over `--api-key`.

CLI output is JSON on stdout by default.

Editable install from this repo:

```bash
cd packages/sdk-python
pip install -e .
```

## Capabilities

- `wl.jobs` — job search, detail, map, and salary averages
- `wl.companies` / `wl.stats` — company search and market stats
- `wl.apply` / `wl.applied_jobs` — apply, Apply with AI, and applied-job tracking
- `wl.resumes` / `wl.cover_letters` — generate resumes and cover letters
- `wl.boards` — public job boards and board apply
- `wl.job_listings` / `wl.employer_jobs` — post and manage employer jobs
- `wl.candidates` / `wl.employees` / `wl.organization` — hiring and org
- `wl.webhooks` / `wl.documents` / `wl.attendance` / `wl.surveys` — Business ops
- `wl.usage` / `wl.billing` / `wl.limits` — usage, billing, and rate limits
- `worklittle` CLI — the same API from the terminal

## Docs

- [SDK](https://docs.worklittle.com/libraries/sdk#python)
- [CLI](https://docs.worklittle.com/libraries/cli)
- [OpenAPI](https://docs.worklittle.com/openapi/openapi.yaml)
- [Worklittle](https://worklittle.com)
