# Breezy HR Jobs & Careers Scraper (`scrapers_lat/breezy-hr-jobs-scraper`) Actor
Scrape open jobs from any company career board on Breezy HR. Extract job title, department, location, employment type, salary, posting date, apply URL and full description. Add multiple companies in one run. Export JSON, CSV or Excel. No login or API key.
- **URL**: https://apify.com/scrapers\_lat/breezy-hr-jobs-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Breezy HR Jobs & Careers Scraper
> Extract every open job from any company hiring on Breezy HR, straight from its public career board, with title, department, location, employment type, salary and full description
Salary data when published
Any company on Breezy HR
JSON / CSV / Excel output formats
No login no API key
### What you get
Point the scraper at one or more Breezy HR company career boards (the company handle in a
`company.breezy.hr` URL, for example `duolingo`, `new-incentives` or `irestorelaser`) and get
every open role on that board as a structured record:
- **title**: the job title
- **company**: the hiring company name
- **companyHandle**: the company handle the job came from
- **department**: the team or department the role sits in
- **location**: the work location as shown on the posting
- **city**, **state**, **country**, **countryCode**: the parsed location parts
- **streetAddress**: the street address when the employer sets one
- **isRemote**: whether the role is remote
- **remoteLabel**: the remote arrangement in words, for example "Fully remote, no location restrictions"
- **locations**: every location attached to the role when it spans more than one
- **employmentType**: full-time, part-time, contract, internship and so on
- **salary**: the pay as displayed on the posting when shown
- **salaryMin**, **salaryMax**, **salaryCurrency**, **salaryPeriod\***: the parsed pay range when the employer publishes one
- **educationRequirements\***, **experienceRequirements\***: the stated requirements when present
- **publishedDate**: when the role was published
- **url**: the public apply link for the job
- **positionId**, **friendlyId**: stable IDs for the posting
- **descriptionHtml\***, **descriptionText\***: the full job description as HTML and as clean plain text
- **observedAt**: when this listing was last seen by the scraper
*\*These fields only appear when Fetch full job details is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Track open roles at target companies for candidate outreach | Recruiters and staffing agencies |
| Read hiring signals to time sales and prospecting | Sales and revenue teams |
| Monitor competitor headcount and team growth | Market and competitive researchers |
| Build a live job board or careers aggregator feed | Job board and marketplace builders |
| Benchmark salaries and analyze roles by location | Talent and labor market analysts |
### Frequently Asked Questions
**What is a Breezy HR company handle and how do I find it?**
The handle is the company name in its Breezy career URL. If a company hires at
`duolingo.breezy.hr`, the handle is `duolingo`. You can paste the handle, the full board URL, or
a single job URL, and the scraper will normalize it. Add one entry per company you want to scrape.
**How many jobs can it return per company?**
It returns every open role on the board, which ranges from a handful to several dozen per company.
Use Max Items to cap the total across all companies when you only need a sample.
**Can I scrape several companies in one run?**
Yes. Add multiple companies and the scraper collects jobs from each board in turn, tagging every
record with its companyHandle so you can tell them apart. The Max Items limit applies to the
combined total.
**Do I get salary data?**
When the employer publishes pay, yes. The scraper captures the displayed salary and, with Fetch
full job details on, a parsed minimum, maximum, currency and period. Roles without published pay
return empty salary fields.
**How do I filter to specific roles?**
Use the Keyword filter to keep only jobs whose title, department, location or description contain
your keyword, for example "engineer", "remote" or "sales". Leave it empty to return every open job.
**What happens if a company has no public board?**
The scraper records an error row for that company with the reason and moves on to the next one, so
one bad entry never stops the run.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [Greenhouse Job Board Listings Scraper](https://apify.com/scrapers_lat/greenhouse-jobs-scraper): Every open role from any company hiring on Greenhouse, with full descriptions.
- [Indeed Jobs & Salary Scraper](https://apify.com/scrapers_lat/indeed-jobs-scraper): Job postings, companies and pay ranges from Indeed.
- [LinkedIn Jobs & Company Scraper](https://apify.com/scrapers_lat/linkedin-jobs-scraper): Job postings with company, seniority and location fields.
- [Seek Australia Jobs & Salary Scraper](https://apify.com/scrapers_lat/seek-jobs-scraper): Job listings and salary data from Seek Australia and New Zealand.
- [Jora Jobs & Salary Scraper](https://apify.com/scrapers_lat/jora-jobs-scraper): Job postings and pay ranges across Jora in Australia, NZ and Asia.
- [GetOnBrd LATAM Tech Jobs Scraper](https://apify.com/scrapers_lat/getonbrd-scraper): Latin American tech job listings with salary data.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish
scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company
registries and government data. Browse the full catalog, see live sample output for each one, or
ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Breezy HR. It only accesses data
> that is publicly available on company career boards. Use it in accordance with Breezy HR's terms
> of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of job listings to collect across all companies. Optional.
## `withDetails` (type: `boolean`):
When enabled, each job includes the full HTML and plain-text description plus salary range, education and experience requirements when the employer publishes them. When disabled, only the listing fields (title, department, location, employment type, apply URL, dates) are collected, which is faster.
## `companies` (type: `array`):
Breezy HR company career boards to scrape. Use the company handle from its careers URL, for example a board at duolingo.breezy.hr means the handle is "duolingo". You can paste the handle, the full board URL, or a specific job URL and the scraper will normalize it. Add one entry per company.
## `searchQuery` (type: `string`):
Optional keyword to keep only matching jobs. Matches against the job title, department, location and description (case-insensitive). Leave empty to return every open job.
## `proxyConfiguration` (type: `object`):
Optional proxy. Public board data is fetched directly by default; enable a proxy only if you run at high volume and want to rotate IPs.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"companies": [
"duolingo",
"new-incentives",
"irestorelaser",
"ourassistants"
]
}
````
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"companies": [
"duolingo",
"new-incentives",
"irestorelaser",
"ourassistants"
],
"searchQuery": ""
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/breezy-hr-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"companies": [
"duolingo",
"new-incentives",
"irestorelaser",
"ourassistants",
],
"searchQuery": "",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/breezy-hr-jobs-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"companies": [
"duolingo",
"new-incentives",
"irestorelaser",
"ourassistants"
],
"searchQuery": ""
}' |
apify call scrapers_lat/breezy-hr-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/breezy-hr-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Breezy HR Jobs & Careers Scraper",
"description": "Scrape open jobs from any company career board on Breezy HR. Extract job title, department, location, employment type, salary, posting date, apply URL and full description. Add multiple companies in one run. Export JSON, CSV or Excel. No login or API key.",
"version": "0.1",
"x-build-id": "iSV5DeJEf1vUytmg4"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~breezy-hr-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-breezy-hr-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~breezy-hr-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-breezy-hr-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~breezy-hr-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-breezy-hr-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"companies"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of job listings to collect across all companies. Optional."
},
"withDetails": {
"title": "Fetch full job details",
"type": "boolean",
"description": "When enabled, each job includes the full HTML and plain-text description plus salary range, education and experience requirements when the employer publishes them. When disabled, only the listing fields (title, department, location, employment type, apply URL, dates) are collected, which is faster.",
"default": true
},
"companies": {
"title": "Companies",
"type": "array",
"description": "Breezy HR company career boards to scrape. Use the company handle from its careers URL, for example a board at duolingo.breezy.hr means the handle is \"duolingo\". You can paste the handle, the full board URL, or a specific job URL and the scraper will normalize it. Add one entry per company.",
"items": {
"type": "string"
}
},
"searchQuery": {
"title": "Keyword filter",
"type": "string",
"description": "Optional keyword to keep only matching jobs. Matches against the job title, department, location and description (case-insensitive). Leave empty to return every open job."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy. Public board data is fetched directly by default; enable a proxy only if you run at high volume and want to rotate IPs."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```