Hiring.cafe Job Listings & Salary Filter Scraper

Hiring.cafe aggregates job postings pulled directly from Greenhouse, Lever, Workable, Workday, SuccessFactors, BambooHR, and thousands of other applicant-tracking systems and company career pages. This actor queries that aggregated index and returns structured job records, so you can filter on dimensions — salary band, security clearance, required tech stack — that most job boards don't expose in their own search UI.

What this actor does

• Runs one or more keyword searches against hiring.cafe's job index and collects matching postings.
• Narrows results by workplace type, seniority, commitment type, years of experience, security clearance, and salary range/currency/frequency.
• Matches separately against job title text, job description text, parsed technology tags, and parsed requirement bullets, so you can target precise phrasing rather than a single blended search box.
• Includes company-level filters (whitelist/blacklist by name or keyword, industry include/exclude) so you can scope a run to or away from specific employers.
• Returns one record per job with company, compensation, and location detail; fields the source doesn't provide for a given job are left out of that record.

Output per job

• id – unique hiring.cafe job ID.
• objectID – search-index object ID for the posting.
• source – originating ATS (e.g. greenhouse, lever, workable, successfactors).
• boardToken – job board token used by the source ATS.
• applyUrl – link back to the original listing on the source ATS.
• title – job title as posted.
• coreJobTitle – hiring.cafe's canonicalized version of the title.
• category – job category, e.g. Engineering, Data, Marketing.
• seniorityLevel – seniority classification, e.g. Entry Level, Senior Level, Director.
• roleType – Individual Contributor or People Manager.
• commitment – Full Time, Part Time, Contract, Internship, Temporary, Seasonal, or Volunteer.
• workplaceType – Remote, Hybrid, or Onsite.
• workplaceCountries – country codes where the role is based.
• workplaceStates – state or region names where the role is based.
• workplaceCities – city names where the role is based.
• latitude / longitude — primary geolocation of the listed workplace, when hiring.cafe provides one.
• salaryMin / salaryMax — disclosed compensation range, omitted when the posting does not publish a transparent salary.
• salaryCurrency – currency code for the disclosed range.
• salaryFrequency – pay period for the disclosed range (Yearly, Monthly, Weekly, Daily, Hourly).
• technicalTools – technologies/tools mentioned in the posting.
• minYearsExperience – minimum years of experience parsed from the posting.
• bachelorsDegreeRequirement – degree requirement level, when stated.
• companyName – hiring company name.
• companyWebsite – company homepage URL.
• companyIndustries – industry tags for the hiring company.
• companyEmployees – employee-count bucket for the hiring company.
• companyHqCountry – country code of the company's headquarters.
• isExpired – whether hiring.cafe has marked the listing expired.
• scrapedAt – ISO 8601 timestamp of when this actor fetched the record.

Input

Field	Type	Default	Description
searchQueries	Array of strings	–	Keywords searched against hiring.cafe (e.g. "software engineer"). Leave empty for unfiltered results.
workplaceTypes	Array (select)	["Remote","Hybrid","Onsite"]	Restrict to these workplace types.
locations	Array	–	Location filter: plain strings ("San Francisco", "United States") or objects with label, value, countryCode, stateCode, city, lat, lng. Empty = global.
jobTitleQuery	String	–	Only jobs whose title contains this phrase.
jobDescriptionQuery	String	–	Only jobs whose description contains this phrase.
technologyKeywordsQuery	String	–	Match against parsed technology tags (e.g. python, kubernetes).
requirementsKeywordsQuery	String	–	Match against parsed requirement bullets.
companyNames	Array of strings	–	Only return jobs from these companies.
excludedCompanyNames	Array of strings	–	Exclude jobs from these companies.
companyKeywords	Array of strings	–	Substring match against company name (include).
excludedCompanyKeywords	Array of strings	–	Substring match against company name (exclude).
industries	Array of strings	–	Only companies in these industries.
excludedIndustries	Array of strings	–	Exclude companies in these industries.
salaryCurrency	String (select)	"" (any)	Currency used to evaluate minSalary/maxSalary.
salaryFrequency	String (select)	"" (any)	Pay period used to evaluate minSalary/maxSalary.
minSalary	Integer	–	Lower compensation bound, combined with currency + frequency.
maxSalary	Integer	–	Upper compensation bound.
onlyTransparentSalaries	Boolean	false	Drop jobs that don't publish a salary range.
minYearsExperience	Integer	0	Only jobs requiring at least this many years of experience.
maxYearsExperience	Integer	20	Only jobs requiring at most this many years of experience.
securityClearances	Array (select)	–	Only jobs requiring one of these clearance levels (e.g. Secret, Top Secret).
sortBy	String (select)	"default"	Result order: default (relevance), newest, oldest, salary_high_to_low, salary_low_to_high.
seniorityLevels	Array (select)	["No Prior Experience Required", "Entry Level", "Mid Level", "Senior Level", "Director", "Executive"]	Restrict to these seniority levels.
commitmentTypes	Array (select)	["Full Time", "Part Time", "Contract", "Internship", "Temporary", "Seasonal", "Volunteer"]	Restrict to these commitment types.
dateFetchedPastNDays	Integer	30	Only include jobs fetched within the last N days.
maxItems	Integer	50	Maximum number of jobs to return across all queries.

Example: remote senior engineering roles with disclosed pay

{
    "searchQueries": ["software engineer"],
    "workplaceTypes": ["Remote"],
    "seniorityLevels": ["Senior Level", "Director"],
    "onlyTransparentSalaries": true,
    "salaryCurrency": "USD",
    "salaryFrequency": "Yearly",
    "minSalary": 150000,
    "maxItems": 100
}

Example: cleared roles near a specific company

{
    "searchQueries": [],
    "excludedCompanyNames": ["Acme Corp"],
    "securityClearances": ["Secret", "Top Secret"],
    "dateFetchedPastNDays": 14,
    "maxItems": 50
}

Example: contract/part-time roles mentioning a specific tech stack

{
    "searchQueries": ["data engineer"],
    "commitmentTypes": ["Contract", "Part Time"],
    "technologyKeywordsQuery": "airflow",
    "maxItems": 30
}

Browser and network behavior

HiringCafe is protected by Cloudflare. The actor uses a direct headful browser first and falls back to a residential proxy only when the direct browser is blocked. No proxy is required for a successful local run.

Use cases

• Talent intelligence – track hiring velocity for a role, company, or region over time.
• Compensation benchmarking – aggregate disclosed salary ranges by role, seniority, and location.
• Remote-work research – isolate workplaceTypes: ["Remote"] postings to study the remote-first job market.
• ATS/tooling market share – group results by source to see which applicant-tracking systems dominate hiring.
• Skills-demand tracking – aggregate technicalTools across postings to spot which technologies are rising in demand.
• Targeted job alerts – run narrow filters (keyword + location + seniority) on a schedule to catch new matching postings.

FAQ

Does this cover jobs outside the US? Yes. hiring.cafe aggregates listings globally; use locations, workplaceCountries in the output, or leave locations empty for worldwide results.

Why are salary fields missing on some jobs? Many postings do not disclose compensation. The actor omits salary fields for non-transparent postings instead of emitting 0. Set onlyTransparentSalaries to true to keep only listings that publish a range.

What's the difference between seniorityLevel and minYearsExperience? seniorityLevel is hiring.cafe's categorical tag (e.g. Mid Level, Senior Level). minYearsExperience is the numeric minimum years parsed from the job description text, and may be 0 when the posting doesn't state a number.

How do searchQueries and the other text filters interact? searchQueries is the general keyword search hiring.cafe runs against the whole posting. jobTitleQuery, jobDescriptionQuery, technologyKeywordsQuery, and requirementsKeywordsQuery are additional, more targeted filters applied on top of that search.

Can I pull postings from one employer only? Yes, set companyNames to that employer's name (or use companyKeywords for a partial match). Use excludedCompanyNames/excludedCompanyKeywords to do the opposite.

Does dateFetchedPastNDays reflect the original posting date? No — it reflects when hiring.cafe's own index last fetched the listing, which is the freshness signal the source provides.

Are expired listings included? hiring.cafe's active search only surfaces current postings, so isExpired is normally false; the field is kept in the output for completeness.

Is this affiliated with hiring.cafe? No. This actor is an independent tool that queries hiring.cafe's public job search and is not affiliated with or endorsed by hiring.cafe.