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

Scrape open jobs from any company's Breezy HR careers site: titles, departments, employment type, locations, remote policy, published salaries with parsed ranges, and full descriptions. Paste a careers site URL, get clean JSON. No login, no API key, no proxy.

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

## Pricing

from $2.50 / 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

![banner](https://anyx.solutions/banners/breezy-jobs-scraper.png)

## Breezy HR Jobs Scraper

**Every open job on any company's Breezy HR careers site — with full descriptions, remote policy and published salaries — as clean JSON.**

Thousands of small and mid-sized companies, staffing firms and nonprofits publish their open
positions on Breezy HR careers sites at `<company>.breezy.hr`. This Actor reads any of those
careers sites and returns every open job: title, company, department, employment type, every
location with its remote policy, street address when given, posting date, the full description as
HTML and plain text, and the salary exactly as shown plus a parsed minimum, maximum, currency and
pay period. Paste a careers site URL; there is no login, no API key, and no proxy to configure.
Built for job aggregators, recruiting and talent-intelligence teams, salary benchmarking, and
hiring-signal tracking.

### ⚡ Quick start

```json
{
  "startUrls": [{ "url": "https://urrly.breezy.hr/" }],
  "maxItems": 5
}
```

### 🧩 Input

| Field                | Type    | Required | Default                      | Description                                                                                                                                                                               |
| -------------------- | ------- | -------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `startUrls`          | array   | yes      | —                            | Breezy HR careers site URLs on a company subdomain (`https://<company>.breezy.hr/`), or single position URLs (`…/p/<position>`).                                                          |
| `maxItems`           | integer | no       | —                            | Maximum number of jobs per start URL. The input form starts at 5; leave it empty to get the whole careers site.                                                                           |
| `includeDescription` | boolean | no       | `true`                       | Open each position's page for its full description and the salary currency. Adds one request per job; turn it off for a fast list of titles, locations and salaries without descriptions. |
| `proxyConfiguration` | object  | no       | `{ "useApifyProxy": false }` | Proxy settings. Breezy HR careers sites need no proxy.                                                                                                                                    |

**Finding a company's careers site.** Open the company's careers page and look for a link to
`<company>.breezy.hr`, or an "Apply" link that starts with it. Use that address as the start URL.

### 📤 Output

Each open job is one dataset row.

#### Fields

| Field             | Type    | Description                                                                                                                                                                                |
| ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`              | string  | Breezy position ID.                                                                                                                                                                        |
| `friendlyId`      | string  | The position's ID and name as they appear in its URL.                                                                                                                                      |
| `title`           | string  | Job title.                                                                                                                                                                                 |
| `company`         | string  | Company name.                                                                                                                                                                              |
| `companySlug`     | string  | The company's name in Breezy URLs.                                                                                                                                                         |
| `companyLogoUrl`  | string  | The company's logo, when it has one.                                                                                                                                                       |
| `careersSiteUrl`  | string  | The company's public careers site.                                                                                                                                                         |
| `url`             | string  | The job's public page.                                                                                                                                                                     |
| `applyUrl`        | string  | The job's application form.                                                                                                                                                                |
| `department`      | string  | Department, when the company sets one.                                                                                                                                                     |
| `employmentType`  | string  | Employment type, e.g. `Full-Time`, `Part-Time`, `Contract`, `Temporary`.                                                                                                                   |
| `location`        | string  | Main location as the careers site shows it, e.g. `New York, NY`.                                                                                                                           |
| `city`            | string  | City of the main location.                                                                                                                                                                 |
| `state`           | string  | State or region of the main location.                                                                                                                                                      |
| `stateCode`       | string  | State or region code of the main location.                                                                                                                                                 |
| `country`         | string  | Country of the main location.                                                                                                                                                              |
| `countryCode`     | string  | Two-letter country code of the main location.                                                                                                                                              |
| `address`         | string  | Street address of the main location, when the company gives one.                                                                                                                           |
| `remote`          | boolean | Whether the job is marked remote.                                                                                                                                                          |
| `remoteType`      | string  | The remote policy, e.g. `Fully remote, no location restrictions`.                                                                                                                          |
| `locations`       | array   | Every location the job is posted in: `name`, `city`, `state`, `stateCode`, `country`, `countryCode`, `remote`.                                                                             |
| `salaryText`      | string  | The salary exactly as the careers site shows it, e.g. `$90,000 – $120,000 / year`. `null` when none is shown.                                                                              |
| `salary`          | object  | The salary parsed: `min`, `max`, `currency` and `period` (`hour`, `day`, `week`, `month`, `year`). An open-ended "120,000+" has no `max`; "Up to" has no `min`. `null` when none is shown. |
| `publishedAt`     | string  | When the job was published (ISO 8601).                                                                                                                                                     |
| `descriptionHtml` | string  | Job description as HTML. `null` when `includeDescription` is off.                                                                                                                          |
| `descriptionText` | string  | Job description as plain text. `null` when `includeDescription` is off.                                                                                                                    |

<details><summary>Example output</summary>

```json
{
  "id": "02bba6c5d7b9",
  "friendlyId": "02bba6c5d7b9-account-executive-builder-finance",
  "title": "Account Executive, Builder Finance",
  "company": "Urrly",
  "companySlug": "urrly",
  "companyLogoUrl": null,
  "careersSiteUrl": "https://urrly.breezy.hr/",
  "url": "https://urrly.breezy.hr/p/02bba6c5d7b9-account-executive-builder-finance",
  "applyUrl": "https://urrly.breezy.hr/p/02bba6c5d7b9-account-executive-builder-finance/apply",
  "department": null,
  "employmentType": "Full-Time",
  "location": "New York, NY",
  "city": "New York",
  "state": "New York",
  "stateCode": "NY",
  "country": "United States",
  "countryCode": "US",
  "address": null,
  "remote": false,
  "remoteType": null,
  "locations": [
    {
      "name": "New York, NY",
      "city": "New York",
      "state": "New York",
      "stateCode": "NY",
      "country": "United States",
      "countryCode": "US",
      "remote": false
    }
  ],
  "salaryText": "$90,000 – $120,000 / year",
  "salary": {
    "min": 90000,
    "max": 120000,
    "currency": "USD",
    "period": "year"
  },
  "publishedAt": "2026-10-01T18:15:52.977Z",
  "descriptionHtml": "<h2>About the Company</h2>\n<p>Urrly is hiring on behalf of a …",
  "descriptionText": "About the Company\n\nUrrly is hiring on behalf of an established real estate finan …"
}
```

</details>

### 💡 Use cases

- **Job aggregation** — feed job boards, newsletters and niche listing sites with fresh postings from the companies you track.
- **Salary benchmarking** — collect published salaries by title, location, pay period and company.
- **Hiring signals** — watch which departments a company is growing, and where, for sales prospecting or investment research.
- **Recruiting intelligence** — monitor competitors' open roles, their remote policy and how long they stay open.

### ❓ FAQ

- **Do I need an API key or a Breezy HR account?** No. The Actor reads the same public careers sites any candidate sees.
- **Do I need a proxy?** No. It runs without one by default.
- **The company's careers page is on its own domain.** Custom domains are not supported as input. Look for an apply link that starts with `<company>.breezy.hr` and use `https://<company>.breezy.hr/`.
- **Why is the salary empty?** Companies choose whether to show pay. `salaryText` and `salary` are `null` when the job shows none.
- **Why is the salary currency sometimes empty?** A `$` sign alone can mean several currencies. The currency is filled in when the position page names it, which needs `includeDescription` on, or when the symbol is unambiguous (such as `€` or `£`). The original text is always kept in `salaryText`.
- **Can I scrape many companies at once?** Yes. Add one careers site URL per company to `startUrls`; `maxItems` applies to each one separately.
- **Why did a run return fewer jobs than expected?** The careers site may list fewer open jobs than you expected, or the company name in the URL may be wrong; the log says when a careers site is not found. Open an issue if something looks off.

### 🔗 More scrapers by Anyx

- [Greenhouse Jobs Scraper](https://apify.com/anyxsolutions/greenhouse-jobs-scraper)
- [Lever Jobs Scraper](https://apify.com/anyxsolutions/lever-jobs-scraper)
- [Workable Jobs Scraper](https://apify.com/anyxsolutions/workable-jobs-scraper)
- [Recruitee Jobs Scraper](https://apify.com/anyxsolutions/recruitee-jobs-scraper)

### 🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

- Email: tantosthor@gmail.com

### 🖼 Image credit

Image credit: [breezy.hr](https://breezy.hr/)

# Actor input Schema

## `startUrls` (type: `array`):

Breezy HR careers site URLs on a company subdomain, such as https://urrly.breezy.hr/. Single position URLs (…/p/<position>) work too. Custom domains are not supported; use the company's <company>.breezy.hr address.

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

Maximum number of jobs to return per start URL. Leave empty to get every open job on the careers site.

## `includeDescription` (type: `boolean`):

Open each position's page to read its full description and the salary currency. Adds one request per job; turn it off for a fast list of titles, locations and salaries.

## `proxyConfiguration` (type: `object`):

Proxy settings. Breezy HR careers sites need no proxy.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://urrly.breezy.hr/"
    }
  ],
  "maxItems": 5,
  "includeDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://urrly.breezy.hr/"
        }
    ],
    "maxItems": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("anyxsolutions/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 = {
    "startUrls": [{ "url": "https://urrly.breezy.hr/" }],
    "maxItems": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("anyxsolutions/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 '{
  "startUrls": [
    {
      "url": "https://urrly.breezy.hr/"
    }
  ],
  "maxItems": 5
}' |
apify call anyxsolutions/breezy-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/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/Nu6JEeOcMbaAjEz5j/builds/zsoGKTqrCmL6eTnmy/openapi.json
