# Company Hiring Lookup — open roles by function & seniority (`agilityy/company-hiring-lookup`) Actor

Give it company names, websites or careers URLs; get open roles by function and seniority, AI/ML roles, remote share, locations and sample titles from the company's public job board (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee or Personio). One row per company.

- **URL**: https://apify.com/agilityy/company-hiring-lookup.md
- **Developed by:** [Agilityy Research](https://apify.com/agilityy) (community)
- **Categories:** Lead generation, Jobs, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$20.00 / 1,000 company hiring lookups

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/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

## Company Hiring Lookup — is this company hiring, for what, and how senior?

You give it company names, websites or careers URLs. You get **one profile per company, right now**: whether it has a
public job board, how many roles are open, which functions and seniority levels, how many are AI/ML, the remote share,
top locations, sample titles and links to the postings. No history to build, no list to maintain: paste 10 or 10,000
companies and the profiles come back in one run.

Each company's public job board on Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee or Personio is found
from the name or domain, verified against the board's own company name (so "Pulse" never returns "Pulse Healthcare"),
and read through the vendor's public JSON/XML feed. No login, no HTML scraping, no personal data.

### Who it is for

- **Sales and revenue operations** — enrich a target list with hiring intent in one run; "hiring 5 SDRs" is a buying
  signal, "0 open roles" is a reason to deprioritize. Fits enrichment waterfalls (Clay and similar).
- **Recruiters** — qualify prospects before the call: who is hiring senior engineers, how many, where, remote or not.
- **Investors and analysts** — a quick headcount-intent read on a company you are about to meet.
- **AI agents** — one tool call per company through Apify's MCP server; one profile, one billed row.

### What you get

| Field | Example | Meaning |
|---|---|---|
| `query`, `found`, `matchedBy`, `checkedAt` | `"notion.so"`, `true`, `"domain"`, `"2026-11-22T09:14:02Z"` | What you asked, whether a board was found and how |
| `company`, `provider`, `slug`, `careersUrl` | `"Notion"`, `"ashby"`, `"notion"`, `"https://jobs.ashbyhq.com/notion"` | The company and its public board |
| `openRoles`, `hiring` | `143`, `true` | Open roles on the board today |
| `functions` | `[{"name": "Engineering", "roles": 61, "sharePct": 42.7}, …]` | Engineering, Data & AI, Product, Design, Sales, Marketing, Customer, Operations, Finance, People, Legal, Clinical, Other |
| `seniorityMix` | `[{"level": "Senior", "roles": 48, "sharePct": 33.6}, …]` | Entry, Mid, Senior, Staff/Principal, Manager, Director, Executive |
| `leadershipRoles` | `9` | Director and Executive roles |
| `aiRoles`, `aiRoleSharePct` | `16`, `11.2` | AI / ML / LLM roles and their share |
| `remoteRoles`, `remoteSharePct` | `49`, `34.3` | Remote roles and their share |
| `topLocations` | `[{"name": "San Francisco, CA", "roles": 52}, …]` | Up to five |
| `sampleTitles`, `jobUrls` | `["Staff Software Engineer, AI", …]` | Ten titles and their apply links |
| `note` | `"No public … board matched this company."` | Why a company has no profile |

Functions and seniority are derived from titles and departments with explainable keyword rules, so two companies
with different department names are still comparable.

```json
{ "query": "Stripe", "found": true, "matchedBy": "name", "company": "Stripe", "provider": "greenhouse",
  "careersUrl": "https://boards.greenhouse.io/stripe", "openRoles": 412, "hiring": true,
  "functions": [{"name": "Engineering", "roles": 171, "sharePct": 41.5}, {"name": "Sales", "roles": 64, "sharePct": 15.5}],
  "seniorityMix": [{"level": "Senior", "roles": 139, "sharePct": 33.7}], "leadershipRoles": 21,
  "aiRoles": 38, "aiRoleSharePct": 9.2, "remoteSharePct": 22.1,
  "topLocations": [{"name": "San Francisco, CA", "roles": 118}], "sampleTitles": ["Account Executive, Enterprise"] }
```

### Input

- `companies` (required) — names (`"Stripe"`), websites (`"notion.so"`) or careers URLs
  (`"https://boards.greenhouse.io/figma"`). One entry per company; a few thousand per run is fine.
- `includeNotFound` (true) — write a row with `found: false` for companies without a detectable board. Switch off to
  skip them; they are then not billed.
- `maxConcurrency` (8) — lookups processed in parallel.

```json
{ "companies": ["Stripe", "notion.so", "https://boards.greenhouse.io/figma", "Ramp"] }
```

Advanced, JSON input only: `"outputMode": "roles"` returns **one row per open role** instead of one profile per
company (title, department, location, remote flag, URL, posted date, function, seniority, AI flag) at $0.0015 per
role. The Greenhouse, Lever, Ashby and Workable Jobs Scraper listings are that mode packaged per vendor.

### How to run it

1. **Console** — paste your companies, click **Run**, download CSV or JSON.
2. **From code, synchronously** — one request returns the profiles:

```
POST https://api.apify.com/v2/acts/agilityy~company-hiring-lookup/run-sync-get-dataset-items?token=<your token>
     body: { "companies": ["Stripe", "notion.so"] }
```

3. **In an enrichment tool** — call the same endpoint per row (Clay, Make, Zapier, n8n all have an HTTP step) and map
   `openRoles`, `functions`, `seniorityMix` and `aiRoleSharePct` to your columns.
4. **AI agents (MCP)** — Apify's MCP server (`https://mcp.apify.com`) exposes this product as a tool; add
   `agilityy/company-hiring-lookup` to the tools your agent may call. "Is Ramp hiring sales leaders?" becomes one
   call and one row.

### Pricing (pay per row)

| Event | Price |
|---|---|
| `company-lookup` — one profile per company | $0.02 |
| `job-row` — one row per open role (`outputMode: "roles"` only) | $0.0015 |

Plus Apify compute, a few cents per run. Examples: 500 accounts enriched once = **$10**; 10,000 companies = $200;
a weekly refresh of 200 prospects ≈ $16 per month. With `includeNotFound` off, companies without a board cost nothing.

### Limits and good to know

- A board with zero open roles counts as not found (there is nothing to profile); the row says so in `note`.
- Name matching is strict on purpose: a company whose board is registered under a different legal or brand name may
  come back `found: false`. Pass the careers URL or the website in that case.
- Only companies on the seven supported job-board vendors can be profiled. Companies on other systems or with no
  public board return `found: false`.
- Only official, public job-board feeds are read. No login, no HTML scraping, no personal data.

### FAQ

**I need to know when this changes, not just today's picture.** Use **Hiring Velocity Signals** (track your own list
daily: roles opened and closed, growth, days-to-fill) or **Hiring Signals Feed** (the same signals for 21,000+
companies with history already in place, pay per row).

**I need every posting, not a profile.** Use `outputMode: "roles"` here, or the **Greenhouse / Lever / Ashby /
Workable Jobs Scraper** listings.

**Is there a free market-wide view?** The weekly Hiring Pulse report across 21,000+ companies is free at
https://hiring.agilityy.com/ .

# Actor input Schema

## `companies` (type: `array`):

Examples: "Stripe", "notion.so", "https://boards.greenhouse.io/figma". Names are matched against the job board's company name to avoid false positives.

## `includeNotFound` (type: `boolean`):

Off = only companies with a live board are written (and billed).

## `maxConcurrency` (type: `integer`):

How many lookups or boards to process in parallel.

## Actor input object example

```json
{
  "companies": [
    "Stripe",
    "notion.so",
    "Figma"
  ],
  "includeNotFound": true,
  "maxConcurrency": 8
}
```

# 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 = {
    "companies": [
        "Stripe",
        "notion.so",
        "Figma"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("agilityy/company-hiring-lookup").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 = { "companies": [
        "Stripe",
        "notion.so",
        "Figma",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("agilityy/company-hiring-lookup").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 '{
  "companies": [
    "Stripe",
    "notion.so",
    "Figma"
  ]
}' |
apify call agilityy/company-hiring-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agilityy/company-hiring-lookup"
        }
    }
}
```

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/4dYw8xTWq3Qf24Oc9/builds/cugQ4OOvwd68vyrBl/openapi.json
