# Teamtailor Jobs & B2B Hiring Signal API (UK/Nordics/EU) (`yan0lovesha/teamtailor-jobs-hiring-signal`) Actor

Extract open jobs, 125+ B2B tech-stack signals, disclosed salary bands, buying intent scores, and SDR cold email hooks from any Teamtailor career site (RSS + JSON-LD fallback). Zero browser overhead, MCP-ready.

- **URL**: https://apify.com/yan0lovesha/teamtailor-jobs-hiring-signal.md
- **Developed by:** [Ling Yan](https://apify.com/yan0lovesha) (community)
- **Categories:** Lead generation, Jobs, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 teamtailor job scrapeds

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

## Teamtailor Jobs & B2B Hiring Signal Intelligence API (Nordics, UK & Europe)

Extract **normalized open job postings**, **125+ enterprise B2B tech-stack signals**, **disclosed salary bands**, **commercial buying intent scores (0–100)**, and **ready-to-send SDR cold email hooks** from any company using **Teamtailor** (`*.teamtailor.com` or custom Teamtailor career domains) — the #1 ATS across **Sweden, Norway, Denmark, Finland, the UK, and European B2B scaleups (10,000+ companies)**.

Built for **Clay.com outbound tables**, **n8n / Make workflows**, **RevOps intent pipelines**, and **AI / MCP Agents** (`LIMITED_PERMISSIONS` native, zero-browser sub-3-second runtime).

***

### Why Outbound Teams & AI Agents Choose This Actor

| Capability | Generic Teamtailor RSS Scrapers | This Actor (`teamtailor-jobs-hiring-signal`) |
| :--- | :---: | :---: |
| **Custom Domains & RSS-Disabled Boards** | Fails when `/jobs.rss` is hidden | **Dual-Channel `/jobs.rss` (`xmlns:tt`) + HTML JSON-LD `JobPosting` Fallback** |
| **Multi-Location & Department Parsing** | Drops `<tt:locations>` & `<tt:department>` | Full city, country, multi-office array & `remoteStatus` (`hybrid`/`remote`/`onsite`) |
| **125+ Enterprise Tech-Stack Signals** | None (escaped HTML dump) | Categorizes **CRM, Cloud, Data, AI/LLM, DevTools, ERP, Security, Product & HR** tools |
| **B2B Buying Signals & 0–100 Score** | None | Detects **Hypergrowth/Budget Expansion**, **Cloud/Platform Migration**, **New VP/Head Hire**, **AI-Native Transformation**, **EU Compliance** |
| **Account-Level Company Dossier** | None | Produces `COMPANY_DOSSIERS` rollup with hiring velocity, tech fingerprint & SDR outreach hook |

***

### Quick Start (Zero Config Required)

Click **Start** in Apify Console — pre-configured with 5 live Nordic/UK/EU tech scaleups (`puzzel`, `rebtel`, `https://career.teamtailor.com`, `nextlane`, `justergroupab`) to return **35+ enriched jobs + 5 executive company dossiers in < 3 seconds**.

#### Example Input (`JSON`)

```json
{
  "sites": [
    "puzzel",
    "rebtel",
    "https://career.teamtailor.com",
    "nextlane",
    "justergroupab"
  ],
  "maxJobsPerCompany": 10,
  "maxTotalJobs": 50,
  "enableIntentExtraction": true,
  "generateCompanyDossier": true,
  "requiredTechStack": [],
  "minIntentScore": 0
}
```

***

### Sample Enriched Output Item

```json
{
  "atsPlatform": "teamtailor",
  "companySlug": "puzzel",
  "companyName": "Puzzel",
  "jobId": "8674333",
  "title": "Senior Backend Engineer (Conversational Intelligence)",
  "department": "Product & Engineering",
  "location": "Oslo, Norway",
  "country": "Norway",
  "workplaceType": "hybrid",
  "jobUrl": "https://puzzel.teamtailor.com/jobs/8674333",
  "intent": {
    "techStackAll": ["Microsoft Azure", "C# / .NET", "Kubernetes", "Python", "OpenAI / GPT"],
    "signalCodes": ["BUDGET_EXPANSION", "AI_TRANSFORMATION_INITIATIVE"],
    "intentScore": 78,
    "intentTier": "HOT",
    "targetBuyerPersona": "CTO / VP Engineering",
    "outreachHook": "Noticed Puzzel is hiring a Senior Backend Engineer (Conversational Intelligence) in Oslo, Norway working across Microsoft Azure, C# / .NET, Kubernetes (Headcount & Budget Expansion)."
  }
}
```

***

### Transparent Pay-Per-Event (PPE) Pricing

Zero charges for 404 domains or jobs filtered out by your criteria:

- **`job-scraped`** *(Primary Event)*: Charged once per matching normalized job pushed to the dataset.
- **`intent-signal-enriched`** *(Optional via `enableIntentExtraction`)*: Charged when B2B tech-stack & buying signal intelligence is extracted for a job.
- **`company-dossier-generated`** *(Optional via `generateCompanyDossier`)*: Charged once per company executive dossier saved to `COMPANY_DOSSIERS`.

***

### Plug-and-Play Integrations

- **MCP Server (`https://mcp.apify.com`)**: 100% `LIMITED_PERMISSIONS` + typed `output_schema.json` for autonomous AI agent calling with zero approval popups.
- **Clay.com**: Use HTTP API (`POST .../run-sync-get-dataset-items`) with each prospect's Teamtailor domain to enrich open roles, tech stack, and `intent.outreachHook` in one column.
- **n8n / Make**: Schedule daily/weekly intent scans across UK & Nordic SaaS targets and route `HOT` accounts directly to Instantly, HubSpot, or Slack.

# Actor input Schema

## `sites` (type: `array`):

List of Teamtailor slugs (e.g. 'puzzel') or full URLs (e.g. 'https://career.teamtailor.com'). Automatically uses /jobs.rss with HTML JSON-LD fallback.

## `maxJobsPerCompany` (type: `integer`):

Maximum open jobs to return per Teamtailor career site.

## `maxTotalJobs` (type: `integer`):

Global cap on total jobs returned across the run for strict PPE cost control.

## `titleKeywords` (type: `array`):

Only return jobs whose title matches at least one keyword (case-insensitive, e.g. 'Engineer', 'Backend', 'AI', 'Sales').

## `departmentFilter` (type: `string`):

Case-insensitive substring filter on Teamtailor department or role (e.g. 'Engineering', 'Data', 'Finance').

## `locationFilter` (type: `string`):

Case-insensitive substring filter on location or country (e.g. 'Stockholm', 'London', 'Oslo', 'United Kingdom').

## `onlyRemoteOrHybrid` (type: `boolean`):

When enabled, excludes strictly onsite jobs.

## `enableIntentExtraction` (type: `boolean`):

Extracts 125+ enterprise software tools across 9 categories, commercial buying signals, 0-100 intent score, target buyer persona, disclosed salary bands, and SDR cold email hook.

## `requiredTechStack` (type: `array`):

Only return jobs mentioning at least one specified tool (e.g. 'GCP', 'BigQuery', 'Rust', '.NET', 'Salesforce', 'AWS').

## `minIntentScore` (type: `integer`):

Filter out low-signal positions below this Buying Intent Score.

## `generateCompanyDossier` (type: `boolean`):

Aggregates all scraped roles per company into an executive Account Intelligence Dossier stored under COMPANY_DOSSIERS in the Key-Value Store.

## `includeDescriptionHtml` (type: `boolean`):

Include raw HTML description alongside normalized plain text.

## `concurrency` (type: `integer`):

Number of Teamtailor career sites processed concurrently.

## Actor input object example

```json
{
  "sites": [
    "puzzel",
    "rebtel",
    "https://career.teamtailor.com",
    "nextlane",
    "justergroupab"
  ],
  "maxJobsPerCompany": 10,
  "maxTotalJobs": 50,
  "titleKeywords": [],
  "departmentFilter": "",
  "locationFilter": "",
  "onlyRemoteOrHybrid": false,
  "enableIntentExtraction": true,
  "requiredTechStack": [],
  "minIntentScore": 0,
  "generateCompanyDossier": true,
  "includeDescriptionHtml": false,
  "concurrency": 5
}
```

# Actor output Schema

## `jobsDataset` (type: `string`):

Open Teamtailor jobs with extracted B2B tech stack, commercial buying signals, salary bands, 0-100 intent score, and SDR outreach hooks.

## `companyDossiers` (type: `string`):

Executive company-level rollup of tech stack, hiring velocity, decision-maker openings, and account outreach hooks.

## `runSummary` (type: `string`):

Execution metrics, feed channels used (RSS vs HTML JSON-LD), and PPE event counts.

# 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 = {
    "sites": [
        "puzzel",
        "rebtel",
        "https://career.teamtailor.com",
        "nextlane",
        "justergroupab"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("yan0lovesha/teamtailor-jobs-hiring-signal").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 = { "sites": [
        "puzzel",
        "rebtel",
        "https://career.teamtailor.com",
        "nextlane",
        "justergroupab",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("yan0lovesha/teamtailor-jobs-hiring-signal").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 '{
  "sites": [
    "puzzel",
    "rebtel",
    "https://career.teamtailor.com",
    "nextlane",
    "justergroupab"
  ]
}' |
apify call yan0lovesha/teamtailor-jobs-hiring-signal --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,yan0lovesha/teamtailor-jobs-hiring-signal"
        }
    }
}
```

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/7QopN9Y7SfmtyHhGm/builds/NaPY0BGofNW6V3S2V/openapi.json
