{ "openapi": "3.0.1", "info": { "title": "Teamtailor Jobs Scraper & API - ATS Career Page Data", "description": "Scrape jobs from any Teamtailor career site by company, subdomain or URL, no API key or login. Get title, description, department, location, remote status, employment type, salary, apply URL, and the hiring recruiter name and email. Filter by keyword, location or department. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "wSV8ENlMkYsKUCCbp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~teamtailor-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~teamtailor-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~teamtailor-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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", "required": [ "companies" ], "properties": { "companies": { "title": "Teamtailor career sites", "type": "array", "description": "Companies to scrape. Add the Teamtailor subdomain (for example career for career.teamtailor.com), the full career site URL, or a custom career domain such as https://jobs.lunar.app. Add one entry per company.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Optional. Teamtailor career-site or job URLs to scrape, in addition to the Companies list. Accepts an Apify request list (objects with a url) or plain URL strings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxJobs": { "title": "Max jobs", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of jobs to collect across all companies. Leave empty for no overall limit. Free Apify plans are always capped at 10 results per run." }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "type": "integer", "description": "Optional. Cap the number of jobs collected from each career site (useful when scraping many companies at once). Leave empty for no per-company limit." }, "withDetails": { "title": "Fetch full job details", "type": "boolean", "description": "When enabled, each job includes the full description (text and HTML), employment type, posting date, closing date, salary when the employer lists one, the structured job location (city, region, country), department, remote status and the hiring contact. When disabled, only the lightweight listing fields are collected.", "default": true }, "searchQuery": { "title": "Keyword filter", "type": "string", "description": "Optional keyword phrase to filter jobs. Matches against the job title, department, location and company (case-insensitive). Leave empty to return every open job." }, "keywords": { "title": "Keywords (match any)", "type": "array", "description": "Optional list of keywords. A job is kept if any keyword appears in its title, department, location, company or description.", "items": { "type": "string" } }, "location": { "title": "Location filter", "type": "array", "description": "Optional. Keep only jobs whose location (city, region or country) matches any of these values. Case-insensitive substring match.", "items": { "type": "string" } }, "department": { "title": "Department filter", "type": "array", "description": "Optional. Keep only jobs whose department matches any of these values. Case-insensitive substring match.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within days", "minimum": 1, "type": "integer", "description": "Optional freshness filter. Keep only jobs posted within this many days. Requires Fetch full job details (the posting date comes from the job page)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Public Teamtailor career sites work without a proxy, so this is off by default. Enable an Apify proxy only if you scrape at high volume and want IP rotation." } } }, "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 } } } } } } } } } }