Skip to main content

4.2M+ live jobs from 63,000+ companies. An open dataset and Python toolkit for ATS and job-source data.

Project description

ats-scrapers

ats-scrapers

An open dataset and Python toolkit for job data from ATS platforms and public sources.

PyPI Python License

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

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ats_scrapers-0.1.0.tar.gz (206.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ats_scrapers-0.1.0-py3-none-any.whl (273.3 kB view details)

Uploaded Python 3

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

Hashes for ats_scrapers-0.1.0.tar.gz
Algorithm Hash digest
SHA256 eacde2016941b3da4c7ca41f3713cc07e21c8124295c07e6b7542884c954852b
MD5 5f844447af988e882a74d98671c8f1fe
BLAKE2b-256 03d9de6b519d5289507b75ed12ecea61f741897ffbd7776caa6832414e62bc91

See more details on using hashes here.

File details

Details for the file ats_scrapers-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ats_scrapers-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 11d3b56e14820a2bc5823d7dcfddc01b77475a54dee014fe57236f810a8638e2
MD5 7cd7c061da44edc7e1ee7834c37099e4
BLAKE2b-256 ca179a3202cfe247bf599fd0a39f7cd4d9a511e441ecf6a4bc9b54b87397ebe6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page