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.

Indeed is one of the world’s largest job search engines. JobSpy’s Indeed scraper uses Indeed’s GraphQL API and supports searches across 60+ countries. It is currently the best-performing scraper in JobSpy — it imposes minimal rate limiting and returns rich employer data not available from other boards.

Basic usage

Set site_name to "indeed" and provide a country_indeed value:
from jobspy import scrape_jobs

jobs = scrape_jobs(
    site_name="indeed",
    search_term="software engineer",
    location="Austin, TX",
    results_wanted=50,
    hours_old=48,
    country_indeed="USA",
)
print(f"Found {len(jobs)} jobs")
print(jobs.head())

Supported parameters

ParameterTypeDescription
search_termstrKeywords to search for
locationstrCity, state, or region to narrow results
distanceintSearch radius in miles (default: 50)
job_typestrfulltime, parttime, internship, contract
is_remoteboolFilter for remote jobs
hours_oldintOnly jobs posted within this many hours
easy_applyboolFilter for Indeed Apply (hosted on Indeed) jobs
results_wantedintNumber of results to return
offsetintStart results from this position
country_indeedstrCountry to search in (required — see below)

Search filter limitations

Indeed only supports one of the following filter groups per search:
  • hours_old
  • job_type and/or is_remote
  • easy_apply
Combining filters from different groups in the same search call will result in only one group being applied.

country_indeed parameter

The country_indeed parameter is required to determine which Indeed regional site to search. Use the exact country name from the table below. Countries marked with * also support Glassdoor searches.
ArgentinaAustralia *Austria *Bahrain
BangladeshBelgium *Brazil *Bulgaria
Canada *ChileChinaColombia
Costa RicaCroatiaCyprusCzech Republic
DenmarkEcuadorEgyptEstonia
FinlandFrance *Germany *Greece
Hong Kong *HungaryIndia *Indonesia
Ireland *IsraelItaly *Japan
KuwaitLatviaLithuaniaLuxembourg
MalaysiaMaltaMexico *Morocco
Netherlands *New Zealand *NigeriaNorway
OmanPakistanPanamaPeru
PhilippinesPolandPortugalQatar
RomaniaSaudi ArabiaSingapore *Slovakia
SloveniaSouth AfricaSouth KoreaSpain *
SwedenSwitzerland *TaiwanThailand
TurkeyUkraineUnited Arab EmiratesUK *
USA *UruguayVenezuelaVietnam *

Writing effective search queries

Indeed searches both the job title and the description, which can produce unrelated results for broad queries. You can use query operators to refine your results:
SyntaxEffect
"exact phrase"Requires the exact phrase in results
-wordExcludes jobs containing this word
(java OR python)Requires at least one of the listed terms
Combine operators for precise results. This query finds engineering internship postings that mention a programming language but excludes unrelated roles:
search_term='"engineering intern" software summer (java OR python OR c++) 2025 -tax -marketing'

Extra output fields

Indeed returns detailed employer data not available from other job boards:
FieldTypeDescription
company_industrystrIndustry of the hiring company
company_addressesstrPrimary address of the company
company_num_employeesstrEmployee count label (e.g., "1001 to 5000")
company_revenuestrRevenue label (e.g., "$100M to $500M")
company_descriptionstrBrief description of the company
company_logostrURL of the company’s square logo

Notes

  • Indeed is the best scraper currently, with minimal rate limiting compared to other boards.
  • All job board searches, including Indeed, are capped at approximately 1,000 results per query.
  • If you see unrelated roles in the results, refine your search_term using the query operators described above.

Build docs developers (and LLMs) love