Installation

Install JobSpy with pip. Requires Python 3.10 or higher.

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

Install JobSpy

1. 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.

2. 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.

Requirements

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.

Upgrading an existing installation

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