# Greenhouse Companies - Board URL Directory (`igolaizola/greenhouse-companies`) Actor

Find Greenhouse company board URLs, company names, descriptions, job counts, departments, offices, and career domains for recruiting research and job data workflows.

- **URL**: https://apify.com/igolaizola/greenhouse-companies.md
- **Developed by:** [Iñigo Garcia Olaizola](https://apify.com/igolaizola) (community)
- **Categories:** Lead generation, Jobs, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

## Greenhouse Companies Scraper - Board URLs, Company Profiles & Hiring Signals

Find companies that use Greenhouse and collect their public Greenhouse board URLs, company names, descriptions, active job counts, department counts, office counts, and career domains. Use this actor to build target company lists, enrich recruiting datasets, or feed board URLs into the [Greenhouse Jobs Scraper](https://apify.com/igolaizola/greenhouse-jobs-scraper?fpr=ig).

> SEO keywords: **Greenhouse companies scraper**, **Greenhouse board URLs**, **Greenhouse jobs companies**, **Greenhouse API alternative**, **Apify actor**.

### 🤖 What does Greenhouse Companies Scraper do?

Greenhouse Companies Scraper researches public Greenhouse company boards and returns a ranked directory of hiring companies. Each result includes the board URL needed to collect jobs from that company, plus company-level context that helps you prioritize which boards to use.

- **Board URL discovery** - get public Greenhouse job board URLs such as `https://boards.greenhouse.io/stripe`.
- **Company profile data** - collect company names, descriptions, and career page domains when available.
- **Hiring activity signals** - compare active job counts, departments, offices, and recent update dates.
- **Searchable company directory** - filter by company name, board URL, description keywords, or career domains.

**Great for:** recruiting market maps, job board discovery, ATS research, lead generation, talent intelligence, and job data pipelines.

### 💡 Why use Greenhouse Companies?

- **Build better job scrapes** - find board URLs first, then send them to Greenhouse Jobs Scraper for live job listings.
- **Prioritize active employers** - use job, department, and office counts to focus on companies with stronger hiring activity.
- **Research company ecosystems** - discover which organizations use Greenhouse across technology, healthcare, retail, finance, and more.
- **Create lead lists** - export company board URLs and career domains for recruiting, sales, or market research workflows.

### 🚀 Quick Start

1. **Open the actor** - Start **Greenhouse Companies** in Apify Store.
2. **Set `maxItems`** - Choose how many company records you want.
3. **Optionally add `query`** - Search for a company, keyword, board URL, or career domain.
4. **Run the actor** - The actor returns matching companies ranked by hiring activity and profile quality.
5. **Export results** - Download JSON, CSV, Excel, or connect the dataset to another workflow.

### 📝 Input Parameters

| Parameter | Type | Required | Description |
|---|---:|:---:|---|
| `query` | String | No | Optional company, board URL, or keyword search. Leave empty to return the highest-ranked Greenhouse company boards first. |
| `maxItems` | Integer | Yes | Maximum number of company board records to return. Use `0` for unlimited. Default: `100`. |

**Top Greenhouse companies**

```json
{
  "maxItems": 100
}
````

**Find a specific company or keyword**

```json
{
  "query": "stripe",
  "maxItems": 10
}
```

### 📊 Output / Results

Each dataset item is one Greenhouse company board record.

- **boardUrl** *(string)* - Public Greenhouse board URL.
- **boardToken** *(string)* - Greenhouse board identifier used in the public board URL.
- **companyName** *(string)* - Company or organization name.
- **descriptionText** *(string)* - Company description when available.
- **activeJobCount** *(number)* - Number of active jobs found for the company board.
- **departmentCount** *(number)* - Number of departments listed on the board.
- **officeCount** *(number)* - Number of offices or locations listed on the board.
- **careerHosts** *(array)* - Career page domains connected to the board when available.
- **firstPublishedAt** *(string)* - Earliest job publish date found for the board when available.
- **latestUpdatedAt** *(string)* - Most recent job update date found for the board when available.
- **importanceScore** *(number)* - Ranking score used to sort more useful company boards first.

```json
{
  "boardUrl": "https://boards.greenhouse.io/stripe",
  "boardToken": "stripe",
  "companyName": "Stripe",
  "descriptionText": "Stripe builds financial tools and economic infrastructure for the internet.",
  "activeJobCount": 238,
  "departmentCount": 26,
  "officeCount": 31,
  "careerHosts": [
    "stripe.com"
  ],
  "firstPublishedAt": "2024-01-11T18:34:00Z",
  "latestUpdatedAt": "2026-06-10T09:16:21Z",
  "importanceScore": 289
}
```

### 🧭 Tips / Common Recipes

- **Feed the jobs actor:** export `boardUrl` values and use them with Greenhouse Jobs Scraper.
- **Find a brand:** set `query` to the company name, board token, or domain, such as `stripe`, `airbnb`, or `careers`.
- **Build a broad company list:** leave `query` empty and increase `maxItems`.
- **Avoid over-filtering:** `query` is best for company names, board URLs, domains, or very specific keywords. For broad discovery, leave it empty because some companies have short or missing descriptions, while others include many unrelated terms in their profile text.
- **Prioritize active hiring:** sort exported results by `activeJobCount` or use the default `importanceScore` order.

### ⚖️ Legal & Ethical Considerations

This actor returns publicly available company board information. Use the results responsibly, respect applicable laws and platform terms, and avoid using exported data for spam, harassment, discrimination, or any activity that violates privacy or employment regulations.

### 🛟 Support

Questions, custom needs, or unexpected results? Open an issue on the actor page in Apify Store and include your input, run ID, and a short description of what you expected.

# Actor input Schema

## `query` (type: `string`):

Optional company or keyword search. Leave empty to return a full list of Greenhouse company boards ordered by highest rank.

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

Maximum number of company board records to return. Use 0 for unlimited.

## Actor input object example

```json
{
  "query": "",
  "maxItems": 100
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("igolaizola/greenhouse-companies").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("igolaizola/greenhouse-companies").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 '{}' |
apify call igolaizola/greenhouse-companies --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=igolaizola/greenhouse-companies",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Greenhouse Companies - Board URL Directory",
        "description": "Find Greenhouse company board URLs, company names, descriptions, job counts, departments, offices, and career domains for recruiting research and job data workflows.",
        "version": "0.0",
        "x-build-id": "LmfcwMArW5FJ3Vxtx"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/igolaizola~greenhouse-companies/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-igolaizola-greenhouse-companies",
                "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/igolaizola~greenhouse-companies/runs": {
            "post": {
                "operationId": "runs-sync-igolaizola-greenhouse-companies",
                "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/igolaizola~greenhouse-companies/run-sync": {
            "post": {
                "operationId": "run-sync-igolaizola-greenhouse-companies",
                "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": [
                    "maxItems"
                ],
                "properties": {
                    "query": {
                        "title": "Company search query",
                        "type": "string",
                        "description": "Optional company or keyword search. Leave empty to return a full list of Greenhouse company boards ordered by highest rank.",
                        "default": ""
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of company board records to return. Use 0 for unlimited.",
                        "default": 100
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```