# Recruitee Companies Scraper (Career Sites & Leads) (`igolaizola/recruitee-companies`) Actor

Find businesses with Tellent Recruitee.com career sites. Search by company, industry, website, careers URL, location, or description and export names, websites, descriptions, images, and career pages for lead generation, recruiting research, and market intelligence. Download clean JSON, CSV or Excel

- **URL**: https://apify.com/igolaizola/recruitee-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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Recruitee Companies Scraper — Career Sites, Company Data & Leads

Find companies using Recruitee and download structured business and career-site data for recruiting research, lead generation, market mapping, and hiring intelligence. Search by company, industry, website, or description, or provide specific Recruitee URLs to retrieve one clean company profile per result.

> Need current vacancies? Use [Recruitee Jobs Scraper](https://apify.com/igolaizola/recruitee?fpr=ig) to receive one result per open role with complete company context.

### 🤖 What does Recruitee Companies Scraper do?

Recruitee Companies Scraper discovers businesses with public Recruitee career sites and returns company-level profiles without mixing in individual job offers.

- **Company identity** — company name and Recruitee tenant ID
- **Career site** — canonical public recruitment page
- **Corporate website** — the employer's main website when available
- **Company description** — useful context for market research and lead qualification
- **Brand assets** — public icon and image URLs when published
- **Flexible discovery** — search broadly or retrieve a specific list of Recruitee URLs

**Great for:** recruiting agencies, sales teams, HR technology research, company databases, employer monitoring, lead generation, and market intelligence.

> SEO keywords: **Recruitee companies scraper**, **find companies using Recruitee**, **Recruitee company data**, **Recruitee career sites**, **recruiting leads**, **Apify actor**.

### 💡 Why find companies using Recruitee?

- 🎯 **Build recruiting lead lists** — identify employers with active recruitment infrastructure.
- 🗺️ **Map target markets** — discover companies by industry, location, website, or descriptive keywords.
- 📈 **Find growth signals** — use public career sites as an indicator of hiring activity and organizational investment.
- 🔗 **Enrich company records** — add career URLs, websites, descriptions, and brand assets to existing datasets.
- 🔄 **Power outreach workflows** — export company profiles to JSON, CSV, Excel, XML, or Parquet.

### 🧠 Search or retrieve specific companies

#### Search companies

Set `query` to a company name, industry, market, website, or keyword such as `fintech`, `healthcare`, or `renewable energy`. Leave it empty for broad discovery.

#### Use direct Recruitee URLs

Set `urls` when you already have target career or job pages. The actor resolves each valid URL to its company profile. When `urls` is supplied, `query` is ignored.

### 🚀 Quick Start

1. **Add the actor** — Open **Recruitee Companies Scraper** in Apify Store.
2. **Choose a source** — Enter a `query`, add specific `urls`, or leave both empty for broad discovery.
3. **Set a limit** — Use `maxItems` to control the number of company profiles saved.
4. **Run the actor** — Click **Run** or trigger it through the Apify API or SDK.
5. **Download results** — Export the dataset as JSON, CSV, Excel, XML, or Parquet.

### 💳 Pricing

Apify's **Free plan** includes monthly credits suitable for testing targeted searches and small company lists. For larger lead-generation projects or scheduled research, use a paid Apify plan with additional platform credits.

### 📝 Input Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `maxItems` | Integer | Yes | Maximum companies to save. Use `0` to continue until discovery is exhausted. Default `100`. |
| `urls` | Array\[String] | No | Public `*.recruitee.com` career or job URLs to retrieve directly. When supplied, `query` is ignored. |
| `query` | String | No | Find companies by name, industry, careers URL, corporate website, or description. Leave empty for broad discovery. |

#### Example inputs

**Find fintech companies using Recruitee**

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

**Retrieve a list of known company career sites**

```json
{
  "urls": [
    "https://sharecompanygroup.recruitee.com",
    "https://example.recruitee.com/o/software-engineer"
  ],
  "maxItems": 50
}
```

### 📊 Output / Results

Each dataset item represents one company:

- **id** *(string)* — Recruitee tenant identifier
- **name** *(string)* — company or employer name
- **url** *(string)* — canonical public Recruitee career-site URL
- **websiteUrl** *(string, optional)* — corporate or primary website
- **description** *(string, optional)* — public company or career-site description
- **icon** *(string, optional)* — public company icon URL
- **image** *(string, optional)* — public company or career-site image URL

```json
{
  "id": "sharecompanygroup",
  "name": "ShareCompany",
  "url": "https://sharecompanygroup.recruitee.com",
  "websiteUrl": "https://sharecompany.com",
  "description": "Technology and data products for financial markets.",
  "icon": "https://careers.recruiteecdn.com/image/upload/w_100/production/images/company-icon.png",
  "image": "https://careers.recruiteecdn.com/image/upload/q_auto,w_1920/production/images/company-cover.png"
}
```

### 🧭 Tips / Common Recipes

- **Build a vertical lead list:** search `fintech`, `SaaS`, `biotech`, `logistics`, or another target industry.
- **Find regional employers:** search a city, country, or language relevant to your market.
- **Enrich known targets:** supply career URLs in `urls` to obtain consistent company-level records.
- **Explore broadly:** leave `query` and `urls` empty, then filter or sort the downloaded dataset.
- **Collect open roles instead:** use Recruitee Jobs Scraper when you need vacancy-level hiring data.

### ⚙️ Best Practices

- Start with a focused query and a small `maxItems` value to review result relevance.
- Use direct URLs for repeatable monitoring of a fixed company list.
- Some employers may omit optional websites, descriptions, icons, or images.
- `maxItems` applies to the complete run rather than separately to each search source or URL.

### ⚖️ Legal & Ethical Considerations

- Respect Recruitee, employer career-site, and Apify Terms of Service.
- Collect only publicly available company information for a legitimate purpose.
- Handle company contact details or potentially personal information responsibly under GDPR, CCPA, and applicable privacy laws.
- Use reasonable run frequency and avoid abusive collection patterns.
- Verify business information before using it for outreach or consequential decisions.

This Actor is an independent tool and is **not** affiliated with, endorsed by, or sponsored by Recruitee B.V. All trademarks are the property of their respective owners.

### ❓ FAQ

**Does each result represent a company or a job?**

Each result is one company profile. Use Recruitee Jobs Scraper for one result per current job opening.

**Do I need to know the career-site URLs?**

No. Search with `query`, or leave both `query` and `urls` empty for broad discovery.

**What happens when I provide both `urls` and `query`?**

The actor retrieves the supplied `urls` directly and ignores `query`.

**Can I search by industry or location?**

Yes. Try descriptive terms such as `fintech`, `healthcare`, `Berlin`, or `Netherlands`. Result relevance depends on the public company information available.

**Does this actor return current vacancies?**

No. It is optimized for company-level research. Use Recruitee Jobs Scraper for live job-offer data.

### 🛟 Support

Need an additional company field, custom export, or lead-generation workflow?
Open an issue or contact the developer at https://igolaizola.com/#contact or https://t.me/igolaizola

# Actor input Schema

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

Maximum number of companies to return. Set to 0 to continue until discovery is exhausted.

## `urls` (type: `array`):

Optional public \*.recruitee.com URLs to retrieve directly instead of searching.

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

Find companies by name, careers URL, website, or description. Leave empty for broad discovery.

## Actor input object example

```json
{
  "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/recruitee-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/recruitee-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/recruitee-companies --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6lImLTg45yQGLWUq0/builds/e8KWFXo0DM7F18ack/openapi.json