Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/speedyapply/JobSpy/llms.txt

Use this file to discover all available pages before exploring further.

JobSpy

​
What is JobSpy?

JobSpy is a powerful job scraping library with the goal of aggregating job postings from all the popular job boards with a single tool. It scrapes concurrently and returns results as a clean Pandas DataFrame — ready to filter, analyze, or export.

Quick Start

Get up and running in under 5 minutes with a working example

Installation

Install JobSpy via pip — requires Python 3.10+

API Reference

Full reference for the scrape_jobs() function and all parameters

Job Boards

Per-board usage notes, limitations, and tips

​
Key features

8 job boards

Scrape LinkedIn, Indeed, Glassdoor, Google, ZipRecruiter, Bayt, Naukri, and BDJobs from one function call

Concurrent scraping

All boards are scraped simultaneously using ThreadPoolExecutor for maximum speed

Pandas DataFrame output

Results are returned in a structured DataFrame — filter, sort, export to CSV/Excel with ease

Proxy support

Round-robin proxy rotation to bypass rate limiting on restrictive job boards

60+ countries

Indeed and Glassdoor support country-specific searches across 60+ countries worldwide

Salary normalization

Automatically extract and normalize salaries to annual amounts across all pay intervals

​
Supported job boards

Job BoardSite NameCoverage
LinkedInlinkedinGlobal
Indeedindeed60+ countries
Glassdoorglassdoor20+ countries
Google JobsgoogleGlobal
ZipRecruiterzip_recruiterUS & Canada
BaytbaytMiddle East & International
NaukrinaukriIndia
BDJobsbdjobsBangladesh

​
Installation

pip install -U python-jobspy
Python 3.10 or higher is required. See Installation for full setup details.

​
Basic usage

import csv
from jobspy import scrape_jobs

jobs = scrape_jobs(
    site_name=["indeed", "linkedin", "zip_recruiter", "google"],
    search_term="software engineer",
    location="San Francisco, CA",
    results_wanted=20,
    hours_old=72,
    country_indeed="USA",
)
print(f"Found {len(jobs)} jobs")
jobs.to_csv("jobs.csv", quoting=csv.QUOTE_NONNUMERIC, escapechar="\\", index=False)

​
License

JobSpy is open source under the MIT License.

Build docs developers (and LLMs) love

Get started for freeTalk to us