# Teamtailor Jobs Scraper - Career Page Jobs API (`groupoject/teamtailor-jobs-scraper`) Actor Scrape jobs from any public Teamtailor career site. Extract job titles, companies, locations, descriptions, apply URLs, posting dates, and monitor new jobs for alerts. - **URL**: https://apify.com/groupoject/teamtailor-jobs-scraper.md - **Developed by:** [Group Oject](https://apify.com/groupoject) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Teamtailor Jobs Scraper - Career Page Jobs API **Scrape clean job listings from any public Teamtailor career site.** Teamtailor is used by startups, scale-ups, agencies, and European companies to publish branded career pages. This Actor reads the public Teamtailor `jobs.json` feed and returns structured job data: title, company, locations, remote/hybrid signal, employment type, description, apply URL, posting date, and monitoring flags for new jobs. Use it for job boards, recruitment intelligence, lead generation, hiring alerts, labor-market research, and company hiring trackers. --- ### What it does - Scrapes one or many Teamtailor company career sites - Accepts full URLs or simple slugs like `recruitgo` - Extracts full job descriptions from the public JSON feed - Filters by keyword, location, department, and posting freshness - Supports monitor mode for scheduled new-job detection - Outputs one clean dataset row per job - Stores `SUMMARY` and `SOURCES` records in the key-value store No login, cookies, browser, or API key required. --- ### Popular use cases - **Teamtailor jobs scraper** - export all jobs from a company career page. - **Startup hiring tracker** - monitor Teamtailor companies for new roles. - **Recruitment lead generation** - find companies actively hiring by role or location. - **Job board feed** - collect fresh jobs for niche boards and newsletters. - **Labor market research** - track hiring trends across startups and regions. - **New job alerts** - schedule monitor mode and send results to integrations. --- ### Ready-to-run task ideas #### Remote SaaS Jobs from Teamtailor ```json { "companySlugs": ["recruitgo", "parcellab", "leaseweb"], "keywords": ["engineer", "developer", "product", "data"], "locations": ["remote", "hybrid"], "includeDescription": true, "maxJobsPerCompany": 100 } ```` #### European Startup Hiring Tracker ```json { "companySlugs": ["luminorbank", "parcellab", "leaseweb"], "keywords": ["software", "data", "product", "marketing"], "includeDescription": true, "monitorMode": true, "onlyNewJobs": true, "stateKey": "european-startup-teamtailor-hiring" } ``` #### Marketing Jobs on Teamtailor ```json { "companyUrls": ["https://luminorbank.teamtailor.com/jobs", "https://recruitgo.teamtailor.com/jobs"], "keywords": ["marketing", "growth", "content", "seo"], "includeDescription": true, "postedWithinDays": 30 } ``` *** ### Input | Field | Type | Description | |---|---|---| | `companyUrls` | string\[] | Teamtailor URLs such as `https://company.teamtailor.com/jobs` | | `companySlugs` | string\[] | Teamtailor subdomains such as `company` | | `companyUrlsText` | string | Paste URLs/slugs, one per line | | `keywords` | string\[] | Keep jobs matching any keyword | | `locations` | string\[] | Keep jobs matching any location text | | `departments` | string\[] | Keep jobs matching department/title/description text | | `includeDescription` | boolean | Convert HTML description to clean text | | `includeHtmlDescription` | boolean | Include raw HTML description | | `postedWithinDays` | integer | Optional freshness filter | | `monitorMode` | boolean | Store seen job IDs across runs | | `onlyNewJobs` | boolean | Output only new jobs when monitoring | | `stateKey` | string | Stable dedupe key per saved task | *** ### Output ```json { "companyName": "Luminor Group", "companySlug": "luminorbank", "sourceUrl": "https://luminorbank.teamtailor.com", "feedUrl": "https://luminorbank.teamtailor.com/jobs.json", "jobId": "7935820", "title": "Senior Java Software Engineer", "department": "Core API Unit", "locations": ["Riga, LV"], "location": "Riga, LV", "country": "LV", "remoteType": "Hybrid", "employmentType": "FULL_TIME", "description": "Clean text job description...", "applyUrl": "https://luminorbank.teamtailor.com/jobs/7935820...", "jobUrl": "https://luminorbank.teamtailor.com/jobs/7935820...", "postedAt": "2026-06-18T00:00:00+03:00", "validThrough": "2026-07-10T23:59:59+03:00", "isNew": true } ``` *** ### Monitoring new jobs Turn on `monitorMode` and run the Actor on a schedule. The Actor stores seen job IDs in a named key-value store and marks new jobs with `isNew: true`. Use `onlyNewJobs: true` for alert workflows where each run should output only jobs that were not seen before. *** ### Notes - Teamtailor career sites expose a public JSON feed at `/jobs.json`. - Some companies may disable or customize feeds; failed sources appear in the `SOURCES` key-value output. - Remote/hybrid detection is inferred from structured fields and job text when explicit remote metadata is missing. - Use a different `stateKey` for each saved task/search scope. *** ### Related tools - [Indeed Jobs Scraper](https://apify.com/groupoject/indeed-jobs-scraper) - scrape jobs across Indeed, Google Jobs, ZipRecruiter, LinkedIn, and Glassdoor. *** ### Changelog See [CHANGELOG.md](CHANGELOG.md). # Actor input Schema ## `companyUrls` (type: `array`): Teamtailor career site URLs, e.g. https://recruitgo.teamtailor.com/jobs or https://luminorbank.teamtailor.com. ## `companySlugs` (type: `array`): Teamtailor subdomain slugs. Example: recruitgo becomes https://recruitgo.teamtailor.com/jobs.json. ## `companyUrlsText` (type: `string`): Paste one Teamtailor URL or company slug per line. ## `keywords` (type: `array`): Only keep jobs matching any keyword in title, company, location, or description. Leave empty for all jobs. ## `locations` (type: `array`): Only keep jobs matching any location text. Leave empty for all locations. ## `departments` (type: `array`): Only keep jobs matching department/title/description text. Leave empty for all departments. ## `includeDescription` (type: `boolean`): Convert the Teamtailor HTML job description to clean text. ## `includeHtmlDescription` (type: `boolean`): Also include raw HTML job description. ## `maxJobsPerCompany` (type: `integer`): Maximum number of jobs to read from each Teamtailor career site. ## `maxTotalJobs` (type: `integer`): Maximum number of jobs to save across all selected Teamtailor sources. ## `postedWithinDays` (type: `integer`): Optional freshness filter based on published date. ## `monitorMode` (type: `boolean`): Store seen job IDs across runs so scheduled runs can mark new jobs. ## `onlyNewJobs` (type: `boolean`): When monitor mode is on, output only jobs not seen in previous runs. ## `stateKey` (type: `string`): Optional stable key for dedupe state. Use a different key per saved task/search scope. ## `requestDelayMs` (type: `integer`): Delay between company feed requests. Increase this for very large source lists. ## `debugMode` (type: `boolean`): Enable verbose logs for troubleshooting source URLs and filters. ## Actor input object example ```json { "companyUrls": [ "https://luminorbank.teamtailor.com/jobs", "https://recruitgo.teamtailor.com/jobs" ], "keywords": [ "engineer", "developer", "data" ], "includeDescription": true, "includeHtmlDescription": false, "maxJobsPerCompany": 200, "maxTotalJobs": 1000, "monitorMode": false, "onlyNewJobs": false, "requestDelayMs": 300, "debugMode": false } ``` # Actor output Schema ## `jobs` (type: `string`): One row per Teamtailor job: title, company, location, employment type, apply URL, and posting date. ## `summary` (type: `string`): Counts, top companies, top locations, duration, and per-source run status. ## `sources` (type: `string`): Per-company feed status, kept job counts, and any source errors. # 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 = { "companyUrls": [ "https://luminorbank.teamtailor.com/jobs", "https://recruitgo.teamtailor.com/jobs" ], "keywords": [ "engineer", "developer", "data" ] }; // Run the Actor and wait for it to finish const run = await client.actor("groupoject/teamtailor-jobs-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 = { "companyUrls": [ "https://luminorbank.teamtailor.com/jobs", "https://recruitgo.teamtailor.com/jobs", ], "keywords": [ "engineer", "developer", "data", ], } # Run the Actor and wait for it to finish run = client.actor("groupoject/teamtailor-jobs-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 '{ "companyUrls": [ "https://luminorbank.teamtailor.com/jobs", "https://recruitgo.teamtailor.com/jobs" ], "keywords": [ "engineer", "developer", "data" ] }' | apify call groupoject/teamtailor-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=groupoject/teamtailor-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Teamtailor Jobs Scraper - Career Page Jobs API", "description": "Scrape jobs from any public Teamtailor career site. Extract job titles, companies, locations, descriptions, apply URLs, posting dates, and monitor new jobs for alerts.", "version": "1.0", "x-build-id": "waehFaDFPmROmLz7f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~teamtailor-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-teamtailor-jobs-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/groupoject~teamtailor-jobs-scraper/runs": { "post": { "operationId": "runs-sync-groupoject-teamtailor-jobs-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/groupoject~teamtailor-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-groupoject-teamtailor-jobs-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": { "companyUrls": { "title": "Teamtailor career URLs", "type": "array", "description": "Teamtailor career site URLs, e.g. https://recruitgo.teamtailor.com/jobs or https://luminorbank.teamtailor.com.", "items": { "type": "string" } }, "companySlugs": { "title": "Company slugs", "type": "array", "description": "Teamtailor subdomain slugs. Example: recruitgo becomes https://recruitgo.teamtailor.com/jobs.json.", "items": { "type": "string" } }, "companyUrlsText": { "title": "URLs or slugs as text", "type": "string", "description": "Paste one Teamtailor URL or company slug per line." }, "keywords": { "title": "Keyword filters", "type": "array", "description": "Only keep jobs matching any keyword in title, company, location, or description. Leave empty for all jobs.", "items": { "type": "string" } }, "locations": { "title": "Location filters", "type": "array", "description": "Only keep jobs matching any location text. Leave empty for all locations.", "items": { "type": "string" } }, "departments": { "title": "Department filters", "type": "array", "description": "Only keep jobs matching department/title/description text. Leave empty for all departments.", "items": { "type": "string" } }, "includeDescription": { "title": "Include plain text description", "type": "boolean", "description": "Convert the Teamtailor HTML job description to clean text.", "default": true }, "includeHtmlDescription": { "title": "Include HTML description", "type": "boolean", "description": "Also include raw HTML job description.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to read from each Teamtailor career site.", "default": 200 }, "maxTotalJobs": { "title": "Max total jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to save across all selected Teamtailor sources.", "default": 1000 }, "postedWithinDays": { "title": "Posted within days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Optional freshness filter based on published date." }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "Store seen job IDs across runs so scheduled runs can mark new jobs.", "default": false }, "onlyNewJobs": { "title": "Only output new jobs", "type": "boolean", "description": "When monitor mode is on, output only jobs not seen in previous runs.", "default": false }, "stateKey": { "title": "Monitor state key", "type": "string", "description": "Optional stable key for dedupe state. Use a different key per saved task/search scope." }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between company feed requests. Increase this for very large source lists.", "default": 300 }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logs for troubleshooting source URLs and filters.", "default": false } } }, "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 } } } } } } } } } } ```