Skip to content
Back to search

JobSpy

Jobs scraper library for LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, Naukri, BDJobs & HelloWork

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/speedyapply/JobSpy with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/speedyapply/JobSpy'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/speedyapply--jobspy/badge.svg)](/listings/speedyapply--jobspy)

HTML

<a href="/listings/speedyapply--jobspy"><img src="/api/listings/speedyapply--jobspy/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pip install -U python-jobspy

_Python version >= [3.10](https://www.python.org/downloads/release/python-3100/) required_

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 311 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">
  2. <a href="https://github.com/speedyapply/JobSpy"><img src="https://github.com/user-attachments/assets/dcb90340-9469-4808-bc51-868e59a000e0" alt="JobSpy" width="320"></a>
  3. </h1>
  4. <p align="center">
  5. <a href="https://pypi.org/project/python-jobspy/"><img src="https://img.shields.io/pypi/v/python-jobspy" alt="PyPI version"></a>
  6. <a href="https://pypi.org/project/python-jobspy/"><img src="https://img.shields.io/pypi/pyversions/python-jobspy" alt="Python versions"></a>
  7. <a href="https://pepy.tech/projects/python-jobspy"><img src="https://static.pepy.tech/badge/python-jobspy/month" alt="Downloads per month"></a>
  8. <a href="https://github.com/speedyapply/JobSpy/actions/workflows/ci.yml"><img src="https://github.com/speedyapply/JobSpy/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
  9. <a href="https://github.com/speedyapply/JobSpy/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/python-jobspy" alt="License: MIT"></a>
  10. <a href="https://discord.gg/v7WdHnrNcN"><img src="https://img.shields.io/discord/1227411661221269565?label=discord&logo=discord&logoColor=white" alt="Discord"></a>
  11. </p>
  12. **JobSpy** is a job scraping library that aggregates jobs from popular job boards with one tool:
  13. - Scrapes job postings from **LinkedIn**, **Indeed**, **Glassdoor**, **ZipRecruiter**, **Bayt**, **Naukri**, **BDJobs**, **HelloWork** & **SEEK** (with **JobStreet** & **Jobsdb**) concurrently
  14. - Aggregates the job postings in a dataframe
  15. - Proxy support to bypass blocking
  16. <p align="center">
  17. <a href="https://github.com/speedyapply/JobSpy"><img src="https://github.com/cullenwatson/JobSpy/assets/78247585/ec7ef355-05f6-4fd3-8161-a817e31c5c57" alt="JobSpy demo"></a>
  18. </p>
  19. ## Installation
  20. ```
  21. pip install -U python-jobspy
  22. ```
  23. _Python version >= [3.10](https://www.python.org/downloads/release/python-3100/) required_
  24. ## Usage
  25. ```python
  26. from jobspy import scrape_jobs
  27. jobs = scrape_jobs(
  28. site_name=["indeed", "linkedin", "zip_recruiter", "glassdoor"], # also "bayt", "naukri", "bdjobs", "hellowork", "seek"
  29. search_term="software engineer",
  30. location="San Francisco, CA",
  31. results_wanted=20,
  32. hours_old=72,
  33. country_indeed="USA",
  34. # fetch_description=True, # read each job's page on boards whose search results have no description (slower)
  35. # proxies=["user:pass@host:port", "localhost"],
  36. )
  37. print(f"Found {len(jobs)} jobs")
  38. print(jobs.head())
  39. jobs.to_csv("jobs.csv", index=False)
  40. ```
  41. ## Output
  42. ```
  43. SITE TITLE COMPANY LOCATION JOB_TYPE INTERVAL MIN_AMOUNT MAX_AMOUNT JOB_URL DESCRIPTION
  44. indeed Software Engineer AMERICAN SYSTEMS Arlington, VA, USA None yearly 150000 200000 https://www.indeed.com/viewjob?jk=5e409e577046... THIS POSITION COMES WITH A 10K SIGNING BONUS!...
  45. indeed Senior Software Engineer TherapyNotes.com Philadelphia, PA, USA fulltime yearly 110000 135000 https://www.indeed.com/viewjob?jk=da39574a40cb... About Us TherapyNotes is the national leader i...
  46. linkedin Software Engineer - Early Career Lockheed Martin Sunnyvale, CA, USA fulltime yearly None None https://www.linkedin.com/jobs/view/3693012711 Description:By bringing together people that u...
  47. linkedin Full-Stack Software Engineer Rain New York, NY, USA fulltime yearly None None https://www.linkedin.com/jobs/view/3696158877 Rain’s mission is to create the fastest and ea...
  48. zip_recruiter Software Engineer - New Grad ZipRecruiter Santa Monica, CA, USA fulltime yearly 130000 150000 https://www.ziprecruiter.com/jobs/ziprecruiter... We offer a hybrid work environment. Most US-ba...
  49. zip_recruiter Software Developer TEKsystems Phoenix, AZ, USA fulltime hourly 65 75 https://www.ziprecruiter.com/jobs/teksystems-0... Top Skills' Details• 6 years of Java developme...
  50. ```
  51. ## Command line
  52. The package installs a `jobspy` command whose options mirror the `scrape_jobs()` parameters below; `jobspy -h` lists them, the output fields and exit codes.
  53. ```
  54. uv tool install python-jobspy
  55. jobspy "software engineer" --site indeed,linkedin --location Chicago -n 20
  56. jobspy nurse --site indeed,linkedin --hours-old 24 -o jobs.jsonl
  57. jobspy "data analyst" --remote --fields title,company,job_url
  58. ```
  59. ## MCP server
  60. [`mcp-jobspy`](https://pypi.org/project/mcp-jobspy/) is an MCP server that runs with `uvx mcp-jobspy@latest`. See [mcp/README.md](https://github.com/speedyapply/JobSpy/blob/main/mcp/README.md) for setup, tools and proxies.
  61. **Standard config** works for most clients:
  62. ```json
  63. {
  64. "mcpServers": {
  65. "jobspy": {
  66. "command": "uvx",
  67. "args": ["mcp-jobspy@latest"]
  68. }
  69. }
  70. }
  71. ```
  72. ## Parameters for `scrape_jobs()`
  73. ```plaintext
  74. Optional
  75. ├── site_name (list|str):
  76. | linkedin, zip_recruiter, indeed, glassdoor, google, bayt, bdjobs, naukri, hellowork, seek
  77. | (default is all)
  78. │
  79. ├── search_term (str)
  80. |
  81. ├── google_search_term (str)
  82. | search term for google jobs. This is the only param for filtering google jobs.
  83. │
  84. ├── location (str)
  85. │
  86. ├── distance (int):
  87. | in miles, default 50
  88. │
  89. ├── job_type (str):
  90. | fulltime, parttime, contract, temporary, internship, perdiem, other, volunteer
  91. │
  92. ├── proxies (list|str):
  93. | in format ['user:pass@host:port', 'localhost'], or a single proxy as a string
  94. | each job board scraper will round robin through the proxies
  95. | socks proxies on LinkedIn, Indeed and BDJobs need pip install "requests[socks]"
  96. |
  97. ├── is_remote (bool)
  98. │
  99. ├── results_wanted (int):
  100. | number of job results to retrieve for each site specified in 'site_name'
  101. │
  102. ├── easy_apply (bool):
  103. | filters for jobs that are hosted on the job board site
  104. |
  105. ├── user_agent (str):
  106. | override the default user agent which may be outdated
  107. │
  108. ├── description_format (str):
  109. | markdown, html, plain (Format type of the job descriptions. Default is markdown.)
  110. │
  111. ├── offset (int):
  112. | skips that many results (e.g. 25 skips the first 25 and starts from the 26th)
  113. │
  114. ├── hours_old (int):
  115. | filters jobs by the number of hours since the job was posted
  116. | (Glassdoor filters by whole days, so it rounds up to the next day.)
  117. │
  118. ├── verbose (int) {0, 1, 2}:
  119. | Controls the verbosity of the runtime printouts
  120. | (0 prints only errors, 1 is errors+warnings, 2 is all logs. Default is 1.)
  121. │
  122. ├── fetch_description (bool):
  123. | for boards whose search results don't include the job description: fetches each job's
  124. | page for the description and other details (e.g. job type). Without it these are empty
  125. | for those boards. Adds one request per job, so use proxies for larger searches
  126. │
  127. ├── linkedin_fetch_description (bool):
  128. | deprecated, use fetch_description (still works; removed in 2.0)
  129. │
  130. ├── linkedin_company_ids (list[int]):
  131. | searches for linkedin jobs with specific company ids
  132. |
  133. ├── country_indeed (str):
  134. | filters the country on Indeed, Glassdoor & SEEK (default is usa; see below for the names)
  135. |
  136. ├── enforce_annual_salary (bool):
  137. | converts wages to annual salary
  138. |
  139. ├── ca_cert (str)
  140. | path to CA Certificate file for proxies
  141. ```
  142. ## Supported Countries for Job Searching
  143. ### LinkedIn
  144. LinkedIn searches globally & uses only the `location` parameter.
  145. ### ZipRecruiter
  146. ZipRecruiter searches for jobs in **US/Canada** & uses only the `location` parameter.
  147. ### Indeed / Glassdoor
  148. Indeed & Glassdoor support most countries, chosen with the `country_indeed` parameter (default `usa`). Additionally, use the `location`
  149. parameter to narrow down the location, e.g. city & state if necessary.
  150. You can specify the following countries when searching on Indeed (use the exact name, * indicates support for Glassdoor):
  151. | | | | |
  152. |----------------------|--------------|------------|----------------|
  153. | Argentina* | Australia* | Austria* | Bahrain |
  154. | Belgium* | Brazil* | Canada* | Chile |
  155. | China | Colombia | Costa Rica | Czech Republic |
  156. | Denmark | Ecuador | Egypt | Finland |
  157. | France* | Germany* | Greece | Hong Kong* |
  158. | Hungary | India* | Indonesia | Ireland* |
  159. | Israel | Italy* | Japan | Kuwait |
  160. | Luxembourg | Malaysia* | Mexico* | Morocco |
  161. | Netherlands* | New Zealand* | Nigeria | Norway |
  162. | Oman | Pakistan | Panama | Peru |
  163. | Philippines | Poland | Portugal | Qatar |
  164. | Romania | Saudi Arabia | Singapore* | South Africa |
  165. | South Korea | Spain* | Sweden | Switzerland* |
  166. | Taiwan | Thailand | Turkey | Ukraine |
  167. | United Arab Emirates | UK* | USA* | Uruguay |
  168. | Venezuela | Vietnam* | | |
  169. ### Bayt
  170. Bayt searches all countries unless `location` names one it covers, e.g. `"Dubai, UAE"` or `"Saudi Arabia"`.
  171. ### BDJobs
  172. BDJobs searches Bangladesh. `location` takes a division or district, e.g. `"Dhaka"` or `"Chattogram Division"`.
  173. ### Naukri
  174. Naukri searches India. `location` takes a city, e.g. `"Pune"`.
  175. ### HelloWork
  176. HelloWork searches France. `location` takes a French city, postcode or region, e.g. `"Lyon"`. Most jobs are posted in French, so French search terms find more.
  177. ### SEEK / JobStreet / Jobsdb
  178. SEEK searches Australia & New Zealand (SEEK), Indonesia, Malaysia, Philippines & Singapore (JobStreet) and Hong Kong & Thailand (Jobsdb), chosen with the `country_indeed` parameter. `location` takes a suburb, city or region, e.g. `"Melbourne"` or `"Jakarta"`.
  179. ## Notes
  180. * Indeed is the best scraper currently with no rate limiting.
  181. * Indeed's `date_posted` is the day a job was added to Indeed, the same date `hours_old` filters on.
  182. * Most job board endpoints are capped at around 1000 jobs on a given search.
  183. * LinkedIn rate limits bursts of requests with a 429, which clears within about a minute. Use proxies for larger searches.
  184. * Glassdoor rate limits above about 2 requests a second.
  185. ## Frequently Asked Questions
  186. **Q: How do I tell a blocked board from one with no jobs?**
  187. **A:** Failures and ignored options are logged as they happen, and the result's `attrs` carry the same messages so your code can read them:
  188. ```py
  189. jobs.attrs["errors"] # {"linkedin": "response status code 429 (blocked: use a proxy)"}
  190. jobs.attrs["warnings"] # {"bdjobs": ["job_type internship isn't supported, ignoring it"]}
  191. ```
  192. ---
  193. **Q: Why is Indeed giving unrelated roles?**
  194. **A:** Indeed searches the description too.
  195. - use - to remove words
  196. - "" for exact match
  197. Example of a good Indeed query
  198. ```py
  199. search_term='"engineering intern" software summer (java OR python OR c++) 2025 -tax -marketing'
  200. ```
  201. This searches the description/title and must include software, summer, 2025, one of the languages, engineering intern exactly, no tax, no marketing.
  202. ---
  203. **Q: No results when using "google"?**
  204. **A:** Google Jobs is currently unavailable.
  205. ---
  206. **Q: Received a response code 429?**
  207. **A:** The board blocked you for sending too many requests. All of the job board sites are aggressive with blocking. We recommend:
  208. - Wait some time between scrapes (site-dependent).
  209. - Try using the proxies param to change your IP address.
  210. ---
  211. ## JobPost Schema
  212. ```plaintext
  213. JobPost
  214. ├── id
  215. ├── site
  216. ├── job_url
  217. ├── job_url_direct
  218. ├── title
  219. ├── company
  220. ├── location
  221. ├── date_posted
  222. ├── job_type: fulltime, parttime, internship, contract, temporary, ...
  223. ├── salary_source: direct_data, description (parsed from posting)
  224. ├── interval: yearly, monthly, weekly, daily, hourly
  225. ├── min_amount
  226. ├── max_amount
  227. ├── currency
  228. ├── is_remote
  229. ├── job_level
  230. ├── job_function
  231. ├── listing_type
  232. ├── emails
  233. ├── description
  234. ├── company_industry
  235. ├── company_url
  236. ├── company_logo
  237. ├── company_url_direct
  238. ├── company_addresses
  239. ├── company_num_employees
  240. ├── company_revenue
  241. ├── company_description
  242. ├── skills
  243. ├── experience_range
  244. ├── company_rating
  245. ├── company_reviews_count
  246. ├── vacancy_count
  247. └── work_from_home_type
  248. ```
  249. A column is empty when the job board doesn't provide it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.