{ "openapi": "3.0.1", "info": { "title": "SmartRecruiters Jobs Scraper", "description": "Scrape all open jobs from any SmartRecruiters career page — just type the company name. Fast, low-cost and clean: location, remote/hybrid, seniority, salary and skills in one consistent format. Monitor new jobs on a schedule. From $1 per 1,000 jobs.", "version": "0.1", "x-build-id": "JEhrgXkyqLCcNSbQl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~smartrecruiters-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-smartrecruiters-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/tacps126~smartrecruiters-jobs-scraper/runs": { "post": { "operationId": "runs-sync-tacps126-smartrecruiters-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/tacps126~smartrecruiters-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-tacps126-smartrecruiters-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": "Companies", "type": "array", "description": "Company names as they appear in the SmartRecruiters jobs-page address — e.g. careers.smartrecruiters.com/`BoschGroup` or jobs.smartrecruiters.com/**BoschGroup** → `BoschGroup` — or paste the career-page link itself.", "items": { "type": "string" } }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Maximum number of jobs to return.", "default": 200 }, "maxItemsPerSource": { "title": "Max jobs per company", "minimum": 1, "type": "integer", "description": "Optional cap per company, so one large employer can’t use up the whole “Max jobs”." }, "includeDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Open each job’s own page for more fields (full description). Slower — one extra request per job — and only for jobs that pass your filters.", "default": false }, "titleIncludes": { "title": "Title must include", "type": "array", "description": "Keep a job only if its title contains any of these words (case-insensitive), e.g. `engineer`, `developer`.", "items": { "type": "string" } }, "titleExcludes": { "title": "Title must not include", "type": "array", "description": "Drop a job whose title contains any of these words (case-insensitive), e.g. `intern`, `manager`.", "items": { "type": "string" } }, "locationIncludes": { "title": "Location must include", "type": "array", "description": "Keep a job only if its location contains any of these (case-insensitive), e.g. `Berlin`, `Remote`.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Keep only jobs posted in the last N days. Jobs whose board doesn't publish a date are kept." }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs the posting itself marks as remote.", "default": false }, "workModes": { "title": "Work mode", "type": "array", "description": "Keep only these work arrangements. Jobs whose posting doesn't state it are dropped when this is set.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Keep only these employment types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "temporary", "freelance" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary", "Freelance" ] } }, "seniorities": { "title": "Seniority", "type": "array", "description": "Keep only these seniority levels.", "items": { "type": "string", "enum": [ "intern", "junior", "mid", "senior", "lead", "principal", "director", "executive" ], "enumTitles": [ "Intern", "Junior", "Mid", "Senior", "Lead", "Principal / Staff", "Director", "Executive" ] } }, "jobFunctions": { "title": "Job function", "type": "array", "description": "Keep only these job functions (engineering, data, sales, …).", "items": { "type": "string", "enum": [ "engineering", "data", "ai_training", "security", "research", "product", "design", "marketing", "sales", "customer_success", "finance", "people", "legal", "operations", "healthcare", "education" ], "enumTitles": [ "Engineering", "Data", "AI Training", "Security", "Research", "Product", "Design", "Marketing", "Sales", "Customer Success", "Finance", "People", "Legal", "Operations", "Healthcare", "Education" ] } }, "descriptionIncludes": { "title": "Description or skills mention", "type": "array", "description": "Keep a job only if its title, description or skills mention any of these, e.g. `Kubernetes`, `Python`, `SQL`.", "items": { "type": "string" } }, "companyExcludes": { "title": "Exclude companies", "type": "array", "description": "Drop jobs from companies whose name contains any of these, e.g. staffing agencies.", "items": { "type": "string" } }, "minAnnualSalary": { "title": "Minimum yearly salary", "minimum": 0, "type": "integer", "description": "Keep jobs paying at least this per year (hourly and monthly pay are converted), in the posting's currency. Jobs that don't publish pay are kept unless “Only jobs with salary” is on." }, "onlyWithSalary": { "title": "Only jobs with salary", "type": "boolean", "description": "Keep only jobs that publish their pay.", "default": false }, "visaSponsorshipOnly": { "title": "Visa sponsorship only", "type": "boolean", "description": "Keep only jobs whose posting says visa sponsorship is available.", "default": false }, "onlyNew": { "title": "Only new jobs", "type": "boolean", "description": "Return only jobs that no earlier run with the same input has delivered. Schedule the Actor and you pay only for new jobs.", "default": false }, "changesOnly": { "title": "Changes only", "type": "boolean", "description": "Return only jobs that are new, changed or closed since the last run with the same input (or monitor name): changed jobs carry `changeType: \"changed\"` and `changes` with the old and new salary, location, title or work mode; jobs taken down come as `changeType: \"removed\"` (a hiring signal). The first run returns everything as new.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the “only new” history, so several monitors can run side by side. Leave empty to derive it from the input." }, "delivery": { "title": "Send results to Slack, Discord, a webhook or Google Sheets", "type": "object", "description": "Webhook: {\"webhookUrl\": \"https://…\", \"format\": \"json\" | \"slack\" | \"discord\", \"onlyWhenResults\": true, \"includeItems\": 10}. Google Sheets: {\"spreadsheetId\": \"\", \"sheetName\": \"Sheet1\"} plus the service account key below; share the sheet with the service account's e-mail first. Leave empty to only save results in the dataset." }, "googleServiceAccountJson": { "title": "Google service account key (for Sheets)", "type": "string", "description": "Only for Google Sheets delivery: paste the service account's JSON key. Stored encrypted; the account sees only sheets you share with it." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for SmartRecruiters in most runs. Turn on if you schedule very large or very frequent runs.", "default": { "useApifyProxy": false } }, "enrich": { "title": "Normalize & enrich", "type": "boolean", "description": "Normalize every job into one schema: structured location + country code, work mode, employment type, seniority, years of experience, job function, skills, annualized salary, education and visa signals.", "default": true }, "dedupe": { "title": "Deduplicate", "type": "boolean", "description": "Drop duplicate postings (by url + title + company).", "default": true }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }