# Job Search Scraper - Direct from Company Career Pages (`hirebase/job-search`) Actor

Search 4M+ live jobs scraped directly from company career pages (Greenhouse, Workday, Lever & 20+ ATS platforms). No job-board reposts, no expired or ghost jobs. Filter by keyword, title, category, location, remote, salary, experience, visa sponsorship and more.

- **URL**: https://apify.com/hirebase/job-search.md
- **Developed by:** [Hirebase](https://apify.com/hirebase) (community)
- **Categories:** Jobs, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 477 total users, 141 monthly users, 99.5% runs succeeded, 8 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Job Search Scraper - Direct from Company Career Pages

Search **4M+ live job listings** collected straight from company career pages across 80+ ATS platforms - Greenhouse, Workday, Lever, iCIMS, SmartRecruiters, SAP SuccessFactors, and more. Powered by [Hirebase](https://www.hirebase.org).

**Why this scraper instead of scraping LinkedIn or Indeed?**

- 🎯 **Direct from the source** - jobs come from the employer's own career page, not aggregator reposts.
- 🚫 **No expired or ghost jobs** - listings are continuously re-checked and removed when they go offline.
- 🏢 **No duplicate spam** - one canonical listing per job, with the real application link.
- 🧠 **AI-enriched fields** - parsed skills, technologies, salary ranges, experience level, visa sponsorship, benefits, and quality scores for every job.

### What you can filter by

| Filter | Examples |
|---|---|
| Keywords | `Python`, `Kubernetes`, `HIPAA` |
| Job titles | `Software Engineer`, `Account Executive` |
| Job categories | 39 categories, from Software Engineering to Healthcare |
| Workplace type | Remote, Hybrid, In-Person |
| Location | `Austin, Texas, United States` · `Berlin, Germany` + match mode & radius (miles/km) |
| Employment type | Full-time, Part-time, Contract, Internship |
| Experience | Entry → Executive, plus exact years-of-experience min/max |
| Posted | Last N days, or on/after an exact date (`YYYY-MM-DD`) |
| ATS platform | Greenhouse, Workday, Lever, and 19 more |
| Industry | 23 sectors + sub-industry tags |
| Company | Name, Hirebase slug, description keywords (`fintech`, `healthcare AI`), size |
| Salary | Min/max + currency, hide undisclosed |
| Extras | Visa sponsorship, hide recruiting agencies, deduplicate multi-location postings |

### Output

Each result includes: job title, company (name, slug, website, logo), team, direct application link, original job-board link, posting date, location(s), workplace type, employment type, salary range, years of experience, parsed skills & technologies, benefits, education level, visa sponsorship, stable job/company slugs for syncing, plus a cleaned text description and the original HTML.

Export to JSON, CSV, Excel, or feed it into [Make](https://www.make.com), n8n, Zapier, Google Sheets, or the Apify API.

```json
{
  "jobTitle": "Software Engineer, Data Infrastructure",
  "companyName": "Speechify",
  "applicationLink": "https://job-boards.greenhouse.io/speechify/jobs/5975137004",
  "datePosted": "2026-07-18",
  "locationType": "Remote",
  "location": "Dublin, Ireland",
  "jobType": "Full Time",
  "salaryRange": { "min": 30000, "max": 120000, "currency": "USD", "period": "yearly" },
  "skills": ["Python", "Docker", "Terraform"],
  "visaSponsored": true,
  "jobBoard": "greenhouse"
}
```

### Example searches

**Job seeker - daily remote SWE digest.** Keywords `Software Engineer`, workplace type *Remote*, experience *Senior*, minimum salary `150000`, posted within `7` days. Run it on an [Apify Schedule](https://docs.apify.com/platform/schedules) every morning and add the Gmail or Slack integration to get new matches in your inbox.

**Recruiter - map a niche talent market.** Job category *Sales Jobs*, company size `51-200`, company keywords `fintech`, *Hide recruiting agencies* on. Export to Excel and you have every mid-size fintech's live sales hiring in one sheet.

**Data team - keep a job board fresh.** One category per scheduled run, `maxResults` 5000, *Deduplicate results* set to Company + job title, and **Only new since last run** on, so each run saves only jobs added since the previous one. Insert by `jobSlug`/`id`, and schedule the [Expired Jobs Feed](https://apify.com/hirebase/expired-jobs) actor next to it to delist every job that has been taken down.

### Pricing

Pay per result - you're only charged for jobs actually returned, up to **5,000 results per run**.

### FAQ

**Do I need a Hirebase account or API key?**
No - API access is built into the actor. Just set your filters and run; you only pay per result through Apify.

**Why do I sometimes see the same job more than once?**
Some employers publish one posting per location. Set *Deduplicate results* to `Company + job title` to collapse them - skipped duplicates are not billed.

**Why did my run fail with a rate limit error?**
The Hirebase API was temporarily busy. Re-run in a few minutes - if it keeps happening, report it via the actor's Issues tab.

**I searched several keywords and got unrelated jobs - why?**
Keywords broaden the search: each keyword adds matches (OR logic) rather than narrowing them. For precise searches, use one focused keyword or combine the *Job titles* / *Job categories* filters with your keyword.

**How fresh is the data?**
Career pages are crawled continuously; expired listings are filtered out, and you can restrict results to jobs posted in the last N days.

**Can I run it on a schedule?**
Yes - use Apify Schedules to run it hourly or daily with **Only new since last run** turned on: each run saves only jobs added since the previous one, so nothing is billed twice. The first run returns normal results and records the starting point.

**What counts as "new"?**
A job added to Hirebase after the previous run started. Each run checks postings from the two days before that point, so the rare job that reaches a career page more than two days after its posted date can be missed. Changing your filters starts a fresh starting point, and each saved task keeps its own.

**Is this legal?**
The data comes from publicly posted job listings on company career pages, accessed via the Hirebase API.

# Actor input Schema

## `keywords` (type: `array`):

Match anywhere in job descriptions, skills, technologies, and benefits (e.g. <code>Python</code>, <code>Kubernetes</code>).

## `jobTitles` (type: `array`):

Match against parsed job titles (e.g. <code>Software Engineer</code>, <code>Product Manager</code>).

## `jobCategories` (type: `array`):

Limit results to one or more Hirebase job categories.

## `locationTypes` (type: `array`):

Remote, hybrid, or in-person roles.

## `locations` (type: `array`):

One per line, as <code>City, Region, Country</code>, <code>City, Country</code>, or just <code>City</code> (e.g. <code>Austin, Texas, United States</code>).

## `geoFilterMode` (type: `string`):

How strictly locations are matched: <code>auto</code> picks a sensible default, <code>strict</code> requires an exact area match, <code>weak</code> is more forgiving, <code>box</code> uses a bounding box. Only applies when Locations are set.

## `geoRadius` (type: `integer`):

Search radius around each location (default 25). Only applies when Locations are set.

## `geoRadiusUnit` (type: `string`):

Unit for the location radius.

## `jobTypes` (type: `array`):

Full-time, part-time, contract, or internship.

## `experienceLevels` (type: `array`):

Seniority of the role.

## `yoeMin` (type: `integer`):

Only jobs asking for at least this many years of experience.

## `yoeMax` (type: `integer`):

Only jobs asking for at most this many years of experience.

## `includeJobsWithoutYoe` (type: `boolean`):

When using a years-of-experience filter, also keep jobs that don't state a number.

## `postedWithinDays` (type: `integer`):

Only jobs posted in the last N days. Leave empty for all.

## `postedOnOrAfter` (type: `string`):

Only jobs posted on or after this exact date, as <code>YYYY-MM-DD</code> (e.g. <code>2026-07-01</code>). Overrides "Posted within (days)" if both are set.

## `atsPlatforms` (type: `array`):

Only jobs scraped directly from these applicant tracking systems / career-page platforms.

## `industries` (type: `array`):

Company industry sectors.

## `subIndustries` (type: `array`):

Narrower company sub-industry tags (e.g. <code>Fintech</code>).

## `companyName` (type: `string`):

Only jobs from this specific company.

## `companySlug` (type: `string`):

Exact Hirebase company slug (from a company's Hirebase URL), for precise company targeting.

## `companyKeywords` (type: `array`):

Match in company descriptions, services, and products (e.g. <code>fintech</code>, <code>healthcare AI</code>).

## `companySizes` (type: `array`):

Company headcount buckets.

## `hideRecruitingAgencies` (type: `boolean`):

Exclude postings from recruiters and staffing agencies.

## `salaryMin` (type: `integer`):

Only jobs whose salary range reaches at least this amount (annual).

## `salaryMax` (type: `integer`):

Only jobs whose salary range starts at or below this amount (annual).

## `currency` (type: `string`):

Currency for the salary filter.

## `includeJobsWithoutSalary` (type: `boolean`):

When using a salary filter, also keep jobs that don't disclose salary.

## `visaSponsorship` (type: `string`):

Filter by whether the job offers visa sponsorship.

## `fullDescriptionHtml` (type: `boolean`):

Also return the complete description exactly as published on the ATS, in the <code>fullDescriptionHtml</code> field.

## `sortBy` (type: `string`):

Order of results.

## `sortOrder` (type: `string`):

Ascending or descending.

## `maxResults` (type: `integer`):

Maximum number of jobs to save (hard cap 5,000 per run). You are only charged for results actually returned.

## `dedupeBy` (type: `string`):

Skip duplicate postings before they are saved (and billed). <code>Company + job title</code> collapses the same role posted once per location; <code>Content hash</code> only drops byte-identical postings.

## `onlyNewSinceLastRun` (type: `boolean`):

Save only jobs added to Hirebase since this actor (or saved task) last ran with the same filters - for scheduled runs that keep a job board or database fresh. The first run returns normal results and records a starting point. Results are sorted newest first while this is on. Pair it with the Expired Jobs actor to delist what has closed.

## Actor input object example

```json
{
  "keywords": [
    "Python"
  ],
  "geoFilterMode": "auto",
  "geoRadiusUnit": "mi",
  "includeJobsWithoutYoe": true,
  "hideRecruitingAgencies": false,
  "currency": "USD",
  "includeJobsWithoutSalary": true,
  "visaSponsorship": "any",
  "fullDescriptionHtml": false,
  "sortBy": "date_posted",
  "sortOrder": "desc",
  "maxResults": 100,
  "dedupeBy": "none",
  "onlyNewSinceLastRun": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every job matching your filters, one dataset item per job.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "Python"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hirebase/job-search").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["Python"] }

# Run the Actor and wait for it to finish
run = client.actor("hirebase/job-search").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "Python"
  ]
}' |
apify call hirebase/job-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hirebase/job-search"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ODjLELZDsPsgZV8sA/builds/G85u548Nrsuc5rp68/openapi.json