4.2M+ live jobs from 63,000+ companies. An open dataset and Python toolkit for ATS and job-source data.
Project description
ats-scrapers
An open dataset and Python toolkit for job data from ATS platforms and public sources.
ats-scrapers provides two layers:
- A free, hosted dataset with 4.2M+ live jobs from 63,000+ companies across 49 sources.
- More than 50 reusable scraper adapters, including Workday, Greenhouse, Lever, Ashby, SmartRecruiters, and SuccessFactors.
Jobs are collected from ATS endpoints, company career sites, and public job feeds, then normalized into one typed schema. Querying the hosted dataset requires no API key or account.
Install
pip install ats-scrapers
The package is imported as ats_scrapers. Optional extras add only what you
need:
pip install "ats-scrapers[parquet]" # query the full Parquet snapshot
pip install "ats-scrapers[scrapers]" # run the scraper library
pip install "ats-scrapers[all]" # install every runtime extra
Query the public dataset
from ats_scrapers import search
# Per-source searches work with the base install.
jobs = search(
query="machine learning engineer",
location="Paris",
ats="greenhouse",
limit=100,
)
# The result is a pandas DataFrame.
print(jobs[["company", "title", "location", "apply_url"]])
For practical full-dataset queries, install the parquet extra. The base
install is intended for smaller per-source CSV slices.
from ats_scrapers import search
jobs = search(query="data engineer", remote=True, salary_min=80_000)
The live manifest contains current row counts and artifact URLs. See the job schema for field definitions and normalization rules.
Scrape a company
from ats_scrapers.scrapers import get_scraper
scraper = get_scraper("ashby", "openai")
jobs = scraper.fetch()
Scraper classes are also available directly:
from ats_scrapers.scrapers import GreenhouseScraper
jobs = GreenhouseScraper("anthropic").fetch()
Scrapers are async-first — in async code (or for concurrency) use
await scraper.afetch() instead. The sync fetch() also works from
inside a running event loop (Jupyter, FastAPI): it transparently runs
on a worker thread.
Scraper adapters include:
- Major ATS platforms: Greenhouse, Lever, Ashby, Workday, SmartRecruiters, SuccessFactors, Oracle, iCIMS, Workable, Personio, and more.
- First-party company APIs: Amazon, Apple, Google, TikTok, and Uber.
- Public and regional sources: EURES, Bundesagentur, Arbetsformedlingen, Welcome to the Jungle, and others.
Run python -c "from ats_scrapers import list_ats; print(*list_ats())" for the
sources currently present in the hosted dataset.
Contributing
Contributions can add a source, improve an existing scraper, or add companies
to the CSV inventories in
ats-companies/.
The scraper API is intentionally tiny: subclass BaseScraper, set ats, and
implement async def afetch() using self.make_fetcher() for HTTP — retries,
backoff, and error mapping come for free. See
src/ats_scrapers/scrapers/greenhouse.py for a compact reference and the Job
model in src/ats_scrapers/models.py for the schema you populate.
git clone https://github.com/kalil0321/ats-scrapers
cd ats-scrapers
uv sync --extra dev
uv pip install -r pipeline/requirements.txt # repo-only ops/publisher tests
uv run pytest
uv run ruff check .
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ats_scrapers-0.1.0.tar.gz.
File metadata
- Download URL: ats_scrapers-0.1.0.tar.gz
- Upload date:
- Size: 206.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eacde2016941b3da4c7ca41f3713cc07e21c8124295c07e6b7542884c954852b
|
|
| MD5 |
5f844447af988e882a74d98671c8f1fe
|
|
| BLAKE2b-256 |
03d9de6b519d5289507b75ed12ecea61f741897ffbd7776caa6832414e62bc91
|
File details
Details for the file ats_scrapers-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ats_scrapers-0.1.0-py3-none-any.whl
- Upload date:
- Size: 273.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
11d3b56e14820a2bc5823d7dcfddc01b77475a54dee014fe57236f810a8638e2
|
|
| MD5 |
7cd7c061da44edc7e1ee7834c37099e4
|
|
| BLAKE2b-256 |
ca179a3202cfe247bf599fd0a39f7cd4d9a511e441ecf6a4bc9b54b87397ebe6
|