Installation

JobSpy requires Python 3.10 or higher. Check your version with python --version before installing.

Install JobSpy

Install the package

Install JobSpy from PyPI using pip:

pip install -U python-jobspy

The -U flag upgrades JobSpy to the latest version if you already have it installed.

Verify the installation

Confirm the package installed correctly by running a quick import in your terminal:

python -c "from jobspy import scrape_jobs; print('JobSpy installed successfully')"

You should see JobSpy installed successfully printed to the console.

JobSpy installs the following dependencies automatically:

Package	Purpose
Python `>=3.10`	Minimum runtime version
`pandas`	Returns results as a DataFrame
`pydantic`	Validates job post data models
`beautifulsoup4`	Parses HTML from job board pages
`requests`	Makes HTTP requests to job boards
`tls-client`	Handles TLS fingerprinting to avoid blocks
`markdownify`	Converts HTML job descriptions to Markdown
`numpy`	Supports DataFrame operations
`regex`	Extended regex for salary parsing

You do not need to install these packages manually. They are declared as dependencies and installed alongside python-jobspy.

To upgrade to the latest version of JobSpy at any time, run the same install command with the -U flag:

pip install -U python-jobspy

You can check which version you have installed with:

pip show python-jobspy