# BambooHR Jobs Scraper & API β Any Company (`memo23/bamboohr-scraper`) Actor
Scrape every open job from any company on BambooHR. Give a company subdomain and get each role with full description, compensation, location, department and apply URL β via the public careers API. Filter by title, location, remote. No proxy needed. JSON or CSV output.
- **URL**: https://apify.com/memo23/bamboohr-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** Jobs, AI, Agents
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.90 / 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/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
## BambooHR Jobs Scraper π§
Scrape **every open job from any company hosted on [BambooHR](https://www.bamboohr.com/)** (bamboohr.com) β title, full description, compensation, location, department, and apply URL β straight from BambooHR's public careers API. List + per-job detail gives the complete role, including compensation when shown. No login, no anti-bot, no browser.
---
### Why use this scraper
- **Compensation included. BambooHR job detail often carries a published pay range β captured in `salaryText` when present.**
- **Full job detail, not just titles.** Each row carries the entire job: `descriptionHtml` + plain text, compensation (when shown), location(s), employment type, workplace type, and the apply URL.
- **Fast and cheap.** No proxies required (the API has no anti-bot), so runs are quick and your cost stays low.
- **Normalized schema.** Output uses a consistent ATS schema shared with our other ATS scrapers (Ashby, Lever, SmartRecruiters, Personio, BambooHR) β write one parser, reuse it across every ATS.
- **Built-in filters.** Narrow by title, location, department, employment type, remote, or posted date β applied before a row is emitted, so you only pay for matches.
---
### Overview
[BambooHR](https://www.bamboohr.com/) is a widely-used recruiting platform. Many SMBs host their careers on BambooHR at `https://{company}.bamboohr.com/careers`. This actor reads each company's jobs through BambooHR's public careers API and emits one clean, normalized row per open job.
---
### Supported inputs
| Input type | Example | Notes |
|---|---|---|
| **Careers URL** | `https://soundstripe.bamboohr.com` | The company subdomain |
| **Bare subdomain** | `soundstripe`, `beehiiv` | The part before .bamboohr.com |
Provide them in **Start URLs** and/or **Organization slugs**. Mix as many companies as you like in one run.
> **Where's the subdomain?** It's the part before `.bamboohr.com` in the careers URL.
---
### Use cases
- **Job boards & aggregators** β ingest fresh, structured roles from many companies.
- **Recruiting & sourcing tools** β track who's hiring for what, with compensation where disclosed.
- **Market & talent intelligence** β hiring velocity, remote-vs-onsite mix, and salary where shown.
- **Lead generation** β companies actively hiring are buying signals for many B2B products.
- **Personal job search** β pull every role across your target companies into one sheet.
---
### How it works
1. **Resolve** each input to a BambooHR company subdomain.
2. **Fetch** `https://{company}.bamboohr.com/careers/list` (JSON).
3. **Fetch each job's detail** (`/careers/{id}/detail`) for the full description + compensation β capped to `maxItems`, skipped when `includeDescription` is off.
4. **Normalize** to a common ATS schema and **push** one row per job.
Companies are processed in parallel with a sliding-window concurrency cap. No proxy is needed; you can supply one for IP rotation at very large scale.
---
### Input configuration
| Field | Type | Default | Description |
|---|---|---|---|
| `startUrls` | array | β | BambooHR careers URLs or company subdomains (strings or {url} objects). |
| `organizations` | array | β | Bare BambooHR company subdomains, e.g. ["soundstripe","beehiiv"]. Merged with startUrls. |
| `maxItems` | integer | `5000` | Max job rows emitted across the whole run. |
| `maxConcurrency` | integer | `10` | How many companies to fetch in parallel. |
| `titleKeyword` | string | β | Keep only jobs whose title contains this. |
| `location` | string | β | Keep only jobs whose location contains this. |
| `department` | string | β | Keep only jobs whose department contains this. |
| `employmentType` | string | β | Keep only this employment type. |
| `remoteOnly` | boolean | `false` | Keep only remote jobs. |
| `postedAfter` | string | β | Keep only jobs published on/after this date (YYYY-MM-DD). |
| `includeDescription` | boolean | `true` | Include `descriptionHtml` + `descriptionText`. Off skips the per-job detail call (faster/cheaper). |
| `includeRawJson` | boolean | `false` | Attach the original BambooHR payload under `raw`. |
| `proxy` | object | β | Optional. Not required (no anti-bot); use only for IP rotation at scale. |
#### Example input
```json
{
"organizations": ["soundstripe", "beehiiv"],
"maxItems": 300,
"remoteOnly": true
}
````
***
### Output
One row per open job. Example (trimmed):
```json
{
"ats": "bamboohr",
"org": "401auto",
"company": "401Auto",
"jobId": "366",
"globalId": "bamboohr:401auto:366",
"title": "RV Parts & Service Advisor",
"department": "Hamilton",
"team": null,
"employmentType": "Full-Time",
"workplaceType": "OnSite",
"isRemote": false,
"location": "Hamilton, Ontario",
"locations": ["Hamilton, Ontario"],
"compensation": " $55,000-$65,000 per year",
"salaryText": " $55,000-$65,000 per year",
"descriptionHtml": "We are looking forβ¦
",
"descriptionText": "We are looking forβ¦",
"publishedAt": "2023-03-09",
"jobUrl": "https://401auto.bamboohr.com/careers/366",
"applyUrl": "https://401auto.bamboohr.com/careers/366",
"scrapedAt": "2026-06-14T18:26:00.000Z"
}
```
#### Key output fields
| Field | Description |
|---|---|
| `ats` | Always `"bamboohr"` β the source platform. |
| `org` | Company board identifier. |
| `company` | Company display name. |
| `globalId` | Stable, unique key `ats:org:jobId` β use it to dedupe across runs. |
| `title` | Job title. |
| `department` / `team` | Org grouping as set by the company. |
| `employmentType` | Full-time / Part-time / Intern / Contract / Temporary (as the ATS reports it). |
| `workplaceType` / `isRemote` | Remote / Hybrid / OnSite + a boolean remote flag. |
| `location` / `locations` | Primary location + every listed location. |
| `compensation` / `salaryText` | Published pay range when the company shows one. |
| `descriptionHtml` / `descriptionText` | Full job description as HTML and plain text. |
| `publishedAt` | When the role was published (ISO). |
| `jobUrl` / `applyUrl` | Public posting URL + application URL. |
***
### FAQ
**Do I need a proxy?** No. BambooHR's careers API is public with no anti-bot. The proxy field is available only for optional IP rotation at very large scale.
**Why two requests per job?** The BambooHR list endpoint returns summaries only; description and compensation live on each job's detail endpoint. Detail is fetched only up to `maxItems`, and not at all when `includeDescription` is off.
**Can it discover every company on BambooHR?** No β BambooHR has no public directory of all boards (true for every ATS scraper). You supply the companies you care about.
**How many jobs per company?** Whatever they have open β use `maxItems` to cap total output and control cost.
**How fresh is the data?** Live β every run hits BambooHR in real time.
***
### Support
Found a bug or need a field added? Open an issue on the actor's **Issues** tab in the Apify Console.
***
### Additional services
Need a different ATS or job board? We also build scrapers for Ashby, Greenhouse, Workday, Indeed, LinkedIn, Glassdoor, and many more. Check our Apify Store profile.
***
### Explore more scrapers
- **Ashby / Greenhouse / Lever Jobs Scrapers** β open roles from those ATS platforms.
- **Workday Jobs Scraper** β jobs from any Workday career site.
- **Indeed / LinkedIn / Glassdoor** β the major job boards, fast and structured.
***
### β οΈ Disclaimer
This actor collects only **publicly available** job-posting data exposed by BambooHR's own public careers API. It does not access private, authenticated, or personal data, and does not bypass any access control. You are responsible for using the scraped data in compliance with BambooHR's terms, the source companies' terms, and all applicable laws (including GDPR/CCPA). Use the data ethically and lawfully.
***
### SEO Keywords
BambooHR scraper, BambooHR jobs scraper, bamboohr.com scraper, BambooHR careers API, BambooHR ATS scraper, scrape BambooHR jobs, BambooHR careers scraper, ATS job scraper, SMB jobs scraper, job postings API, company careers scraper, compensation data, hiring data, recruiting data.
# Actor input Schema
## `startUrls` (type: `array`):
BambooHR careers URLs (e.g. https://401auto.bamboohr.com) or bare company subdomains.
## `organizations` (type: `array`):
Bare BambooHR company subdomains, e.g. \["avaindustries", "soundstripe"]. The subdomain is the part before .bamboohr.com. Merged with any Start URLs above.
## `maxItems` (type: `integer`):
Hard cap on job rows emitted across the whole run (across all companies). Use it to control billing β large boards like OpenAI have 700+ open roles.
## `maxConcurrency` (type: `integer`):
How many company boards to fetch in parallel.
## `titleKeyword` (type: `string`):
Keep only jobs whose title contains this text (case-insensitive), e.g. "engineer".
## `location` (type: `string`):
Keep only jobs whose location (primary or secondary) contains this text, e.g. "remote", "London", "New York".
## `department` (type: `string`):
Keep only jobs whose department contains this text, e.g. "Engineering".
## `employmentType` (type: `string`):
Keep only jobs with this exact employment type.
## `remoteOnly` (type: `boolean`):
Keep only jobs flagged remote.
## `postedAfter` (type: `string`):
Keep only jobs published on or after this date (YYYY-MM-DD). Ideal for scheduled monitoring runs that only want fresh roles.
## `includeDescription` (type: `boolean`):
Include `descriptionHtml` and `descriptionText` on each row. Turn off for leaner, cheaper rows when you only need title/location/compensation/links.
## `includeRawJson` (type: `boolean`):
Attach the original, unmodified BambooHR job object to each row under a `raw` field. Useful for advanced fields not in the normalized schema. Off by default to keep rows lean.
## `enrichEmails` (type: `boolean`):
If enabled, tries to find a contact email for the company by discovering its website (Clearbit) and reading its contact/about pages. Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort.
## `proxy` (type: `object`):
Optional. BambooHR's public API has no anti-bot, so a proxy is NOT required. Only enable it if you want IP rotation when scraping very large numbers of companies.
## Actor input object example
```json
{
"startUrls": [
"https://401auto.bamboohr.com"
],
"organizations": [
"avaindustries",
"soundstripe"
],
"maxItems": 5000,
"maxConcurrency": 10,
"remoteOnly": false,
"includeDescription": true,
"includeRawJson": false,
"enrichEmails": false
}
```
# 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 = {
"startUrls": [
"https://401auto.bamboohr.com"
],
"organizations": [
"avaindustries",
"soundstripe"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("memo23/bamboohr-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 = {
"startUrls": ["https://401auto.bamboohr.com"],
"organizations": [
"avaindustries",
"soundstripe",
],
}
# Run the Actor and wait for it to finish
run = client.actor("memo23/bamboohr-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 '{
"startUrls": [
"https://401auto.bamboohr.com"
],
"organizations": [
"avaindustries",
"soundstripe"
]
}' |
apify call memo23/bamboohr-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=memo23/bamboohr-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "BambooHR Jobs Scraper & API β Any Company",
"description": "Scrape every open job from any company on BambooHR. Give a company subdomain and get each role with full description, compensation, location, department and apply URL β via the public careers API. Filter by title, location, remote. No proxy needed. JSON or CSV output.",
"version": "0.0",
"x-build-id": "HshTO5qismvu6cNF3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/memo23~bamboohr-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-memo23-bamboohr-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/memo23~bamboohr-scraper/runs": {
"post": {
"operationId": "runs-sync-memo23-bamboohr-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/memo23~bamboohr-scraper/run-sync": {
"post": {
"operationId": "run-sync-memo23-bamboohr-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",
"properties": {
"startUrls": {
"title": "BambooHR careers URLs",
"type": "array",
"description": "BambooHR careers URLs (e.g. https://401auto.bamboohr.com) or bare company subdomains.",
"items": {
"type": "string"
}
},
"organizations": {
"title": "Organization slugs",
"type": "array",
"description": "Bare BambooHR company subdomains, e.g. [\"avaindustries\", \"soundstripe\"]. The subdomain is the part before .bamboohr.com. Merged with any Start URLs above.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Maximum jobs to scrape",
"minimum": 1,
"type": "integer",
"description": "Hard cap on job rows emitted across the whole run (across all companies). Use it to control billing β large boards like OpenAI have 700+ open roles.",
"default": 5000
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"type": "integer",
"description": "How many company boards to fetch in parallel.",
"default": 10
},
"titleKeyword": {
"title": "Title contains",
"type": "string",
"description": "Keep only jobs whose title contains this text (case-insensitive), e.g. \"engineer\"."
},
"location": {
"title": "Location contains",
"type": "string",
"description": "Keep only jobs whose location (primary or secondary) contains this text, e.g. \"remote\", \"London\", \"New York\"."
},
"department": {
"title": "Department contains",
"type": "string",
"description": "Keep only jobs whose department contains this text, e.g. \"Engineering\"."
},
"employmentType": {
"title": "Employment type",
"enum": [
"Full-time",
"Part-time",
"Intern",
"Contract",
"Temporary"
],
"type": "string",
"description": "Keep only jobs with this exact employment type."
},
"remoteOnly": {
"title": "Remote only",
"type": "boolean",
"description": "Keep only jobs flagged remote.",
"default": false
},
"postedAfter": {
"title": "Posted on/after",
"type": "string",
"description": "Keep only jobs published on or after this date (YYYY-MM-DD). Ideal for scheduled monitoring runs that only want fresh roles."
},
"includeDescription": {
"title": "Include full job description",
"type": "boolean",
"description": "Include `descriptionHtml` and `descriptionText` on each row. Turn off for leaner, cheaper rows when you only need title/location/compensation/links.",
"default": true
},
"includeRawJson": {
"title": "Include raw BambooHR payload",
"type": "boolean",
"description": "Attach the original, unmodified BambooHR job object to each row under a `raw` field. Useful for advanced fields not in the normalized schema. Off by default to keep rows lean.",
"default": false
},
"enrichEmails": {
"title": "Enrich with company contact emails (experimental)",
"type": "boolean",
"description": "If enabled, tries to find a contact email for the company by discovering its website (Clearbit) and reading its contact/about pages. Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort.",
"default": false
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. BambooHR's public API has no anti-bot, so a proxy is NOT required. Only enable it if you want IP rotation when scraping very large numbers of companies."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```