# Breezy HR Jobs Scraper (`parseforge/breezy-jobs-scraper`) Actor

Scrapes job listings from a company's public Breezy HR careers page. Returns each job as a flat row with title, department, location, type, and application URL.

- **URL**: https://apify.com/parseforge/breezy-jobs-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.69 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner-v4.webp)](https://apify.com/parseforge?fpr=vmoqkp)

### Breezy HR Jobs Scraper

**Scrape job listings from any company's Breezy HR careers page, up to a million per run.** Every listing comes with the job title, department, location, type, and direct application URL. No login or API key. Export to CSV, JSON, Excel, or XML.

Breezy HR hosts thousands of company career sites, but browsing them one by one or setting up RSS feeds for each is slow. This actor reads the public job listing feed directly from any Breezy HR subdomain and returns every open position in a single dataset. supply the company's subdomain and the number of jobs you want.

| Who uses it | What they scrape Breezy HR for |
|---|---|
| Recruiters | Monitor competitor hiring volumes and the roles they are filling this quarter. |
| Job board aggregators | Pull fresh listings from multiple Breezy HR company pages into one searchable feed. |
| Sales teams | Spot companies that are hiring for roles your product serves and reach out with context. |
| Market analysts | Track which departments and locations a target company is investing in. |

### What it does

This Actor collects job listings from a company's public Breezy HR careers page and returns each one as a flat row with the title, department, location, type, and application link.

- 🏢 **Company subdomain input:** provide the part before.breezy.hr, like plat4mation, and the actor builds the full URL.
- 🔗 **Direct application links:** every row includes the URL that sends a candidate straight to the application form.
- 📊 **Flat row output:** each job is one row with a fixed schema, ready for spreadsheets, databases, or dashboards.
- ⚡ **Bulk collection:** set a high maxItems and pull every open role a company has posted in one run.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Breezy HR data

**📈 Track competitor hiring.**

A talent intelligence analyst runs the scraper weekly on five competitor subdomains to report which departments are growing fastest.

**🗂️ Build a niche job board.**

A developer pulls listings from 50 Breezy HR company pages each night and feeds them into a filtered job board for remote tech roles.

**🎯 Find sales triggers.**

A sales rep scrapes a target account's careers page, spots a new opening for a role their tool supports, and sends a tailored pitch to the hiring manager.

**🌍 Map geographic expansion.**

A market researcher collects all jobs from a company and plots the city and country fields to visualize where the company is opening new offices.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key needed** | Reads the public job feed directly, no registration or OAuth. |
| **One subdomain, all jobs** | Covers every department, location, and type the company has posted. |
| **Fixed output schema** | Every run returns the same columns, so your pipeline never breaks. |
| **Runs on Apify** | Schedule it, integrate it, or call it from your own code with the API. |

### How it compares

No other Store actor targets Breezy HR the same way, so the honest comparison is with the alternatives teams actually weigh.

| | Breezy HR Jobs Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Breezy HR changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor with a company subdomain and a maximum number of jobs, and it returns every listing it finds up to that limit. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "company": "plat4mation",
 "maxItems": 10
}
```

A larger pull:

```json
{
 "company": "plat4mation",
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.0085 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.85 |
| 1,000 results | $8.50 |
| 10,000 results | $85.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Breezy HR Jobs Scraper](https://apify.com/parseforge/breezy-jobs-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Breezy HR through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/breezy-jobs-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**The run finishes but returns zero jobs.**

Check the company subdomain you entered. It must be the exact part before.breezy.hr, with no extra characters, spaces, or the full URL. Also confirm the company still uses Breezy HR for their careers page.

**I get an error that the page cannot be reached.**

Verify the subdomain is correct and that the careers page loads in a regular browser. Some companies remove or rename their Breezy HR subdomain, which would cause this error.

**The dataset has fewer jobs than I expected.**

The scraper collects only the jobs publicly listed on the Breezy HR page at that moment. If the company has fewer open roles than your maxItems setting, you will get all of them and the run will finish normally.

**Some fields are empty in the output.**

Breezy HR lets companies leave certain fields blank when they post a job. If a department or location is missing from a row, the company did not fill it in on their listing.

**The run times out before collecting all jobs.**

Lower the maxItems value and run the scraper more frequently, or increase the run timeout in the Actor's advanced settings if the company has thousands of open roles.

### FAQ

| Question | Answer |
|---|---|
| How do I find the company subdomain? | Look at the company's Breezy HR careers URL. If the address is https://plat4mation.breezy.hr, the subdomain is plat4mation. Enter that exact string into the Company field. |
| Does this scraper require a Breezy HR account or API key? | No. It reads the public job listing feed that every Breezy HR careers page exposes, so no login, account, or API key is needed. |
| What job fields does the scraper return? | Each row includes the job title, department, location, employment type, and the direct URL to the application page. The exact field list is shown in the sample output on the Actor's page. |
| Can I scrape multiple companies at once? | One run scrapes one company subdomain. To scrape many companies, run the Actor multiple times with different subdomains, or use Apify's scheduling and queue features to loop through a list. |
| How many jobs can I collect in one run? | You set the maximum with the 'Maximum jobs' field. The upper limit is 1,000,000, but the actual number returned depends on how many open roles the company has posted. |
| What output formats are supported? | You can export your dataset to CSV, JSON, Excel, XML, or RSS from the Apify console or via the API. |
| Does the scraper handle pagination? | Yes. It follows the Breezy HR listing pages automatically until it reaches your maxItems limit or runs out of jobs. |
| Can I filter jobs by department or location? | The scraper collects all open jobs from the company. Filter by department, location, or type after the run by sorting your dataset in a spreadsheet or with a simple script. |
| Is this an official Breezy HR integration? | No. This is an independent scraper that reads publicly available job listing data from Breezy HR careers pages. |
| How often should I run the scraper? | Most users run it daily or weekly. You can schedule recurring runs in Apify to keep your dataset fresh without manual work. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Breezy HR, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `company` (type: `string`):

Required. The Breezy HR subdomain of the company careers page (the part before .breezy.hr). For example, for https://plat4mation.breezy.hr use plat4mation.

## `maxItems` (type: `integer`):

Maximum number of job listings to collect per run.

## Actor input object example

```json
{
  "company": "plat4mation",
  "maxItems": 10
}
```

# Actor output Schema

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

No description

# 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 = {
    "company": "plat4mation",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/breezy-jobs-scraper").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 = {
    "company": "plat4mation",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/breezy-jobs-scraper").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 '{
  "company": "plat4mation",
  "maxItems": 10
}' |
apify call parseforge/breezy-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/breezy-jobs-scraper"
        }
    }
}
```

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/6CMND0Cd9QjfPNAXs/builds/2mTfdgIFGhfOBOFde/openapi.json