{ "openapi": "3.0.1", "info": { "title": "SmartRecruiters Jobs Scraper - Company Career Page API", "description": "SmartRecruiters jobs scraper for any company career board. Export titles, departments, job functions, locations, remote flag, employment and experience level, full descriptions and apply links for many companies per run, and get only new openings on a schedule. No login, proxy or API key.", "version": "1.0", "x-build-id": "MEPFsJDyYQNeLbda3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~smartrecruiters-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-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/groupoject~smartrecruiters-jobs-scraper/runs": { "post": { "operationId": "runs-sync-groupoject-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/groupoject~smartrecruiters-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-groupoject-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", "properties": { "companyUrls": { "title": "SmartRecruiters career URLs", "type": "array", "description": "Public SmartRecruiters company or job URLs, for example https://jobs.smartrecruiters.com/BoschGroup.", "items": { "type": "string" } }, "companyIds": { "title": "Company IDs", "type": "array", "description": "SmartRecruiters company identifiers such as BoschGroup, Visa, or Ubisoft2.", "items": { "type": "string" } }, "companyUrlsText": { "title": "URLs or company IDs as text", "type": "string", "description": "Paste one SmartRecruiters URL or company ID per line." }, "keywords": { "title": "Keyword filters", "type": "array", "description": "Keep jobs matching any keyword in the title, company, location, department, or description. Leave empty for all jobs.", "items": { "type": "string" } }, "locations": { "title": "Location filters", "type": "array", "description": "Keep jobs matching any city, region, or country text.", "items": { "type": "string" } }, "departments": { "title": "Department or function filters", "type": "array", "description": "Filter by department or job function, such as Engineering, Sales, or Marketing.", "items": { "type": "string" } }, "employmentTypes": { "title": "Employment type filters", "type": "array", "description": "Filter by employment labels such as Full-time, Part-time, Contract, or Internship.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only keep postings marked or described as remote.", "default": false }, "includeDescription": { "title": "Include plain text description", "type": "boolean", "description": "Fetch each posting and combine its description sections into clean text.", "default": true }, "includeHtmlDescription": { "title": "Include HTML description", "type": "boolean", "description": "Also keep the original HTML from SmartRecruiters job-ad sections.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum postings to read from each company board.", "default": 100 }, "maxTotalJobs": { "title": "Max total jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum dataset rows across all company boards.", "default": 500 }, "postedWithinDays": { "title": "Posted within days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Optional freshness filter based on the SmartRecruiters release date." }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "Remember job IDs across runs so schedules can identify new openings.", "default": false }, "onlyNewJobs": { "title": "Only output new jobs", "type": "boolean", "description": "With monitor mode enabled, save only postings not seen in previous runs.", "default": false }, "stateKey": { "title": "Monitor state key", "type": "string", "description": "Optional stable key. Use a different value for each saved monitoring task." }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between detail and company API calls.", "default": 100 }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logs for troubleshooting.", "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 } } } } } } } } } }