{ "openapi": "3.0.1", "info": { "title": "Jobs.ch Jobs Scraper", "description": "The Jobs.ch Jobs Scraper extracts Swiss job vacancies from Jobs.ch by keyword, location and workload, capturing original advert text kept separate from translations, source language, every workplace, published salaries, companies and hours — ideal for Swiss recruiting and labour-market research.", "version": "0.0", "x-build-id": "f4ia5b27mIALSfaPI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~jobs-ch-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-jobs-ch-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/piotrv1001~jobs-ch-jobs-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-jobs-ch-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/piotrv1001~jobs-ch-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-jobs-ch-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": { "keywords": { "title": "Job title or keyword", "type": "string", "description": "What to search for, in any Swiss language, e.g. `software`, `comptable`, `Pflegefachfrau`, `contabile`.", "default": "software" }, "location": { "title": "Location", "type": "string", "description": "A Swiss town, canton or region, e.g. `Zürich`, `Genève`, `Ticino`. Leave empty to search all of Switzerland. Jobs with several workplaces appear if any of them matches, and every workplace is kept in `locations`.", "default": "Zürich" }, "workloadMin": { "title": "Minimum workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Pensum filter, e.g. 40 for part-time jobs from 40%. jobs.ch matches any job whose offered range overlaps your range (a 60–100% job matches 40–60%)." }, "workloadMax": { "title": "Maximum workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Pensum filter, e.g. 60 for jobs up to 60%." }, "workloadFullyInRange": { "title": "Whole workload range must fit", "type": "boolean", "description": "Keep only jobs whose entire offered range lies inside your minimum and maximum (a 60–100% job is dropped for 40–60%). Dropped jobs are not charged and are counted in the run summary.", "default": false }, "language": { "title": "Translation language", "enum": [ "en", "de", "fr" ], "type": "string", "description": "The original advert text is always saved as written. With full details on, adverts written in another language also get jobs.ch's own translation into this language in `titleLocalized` / `descriptionLocalized`.", "default": "en" }, "startUrls": { "title": "Jobs.ch URLs", "type": "array", "description": "Search pages copied from your browser (with any filters applied on the site), category pages such as `https://www.jobs.ch/en/vacancies/information-technology-telecom/`, or single job pages like `https://www.jobs.ch/en/vacancies/detail/58361213-0012-480c-9b23-856f6c756380/`. The workload inputs above apply only to the keyword search.", "items": { "type": "string" } }, "scrapeDetails": { "title": "Scrape full job details", "type": "boolean", "description": "Open every job and add the full original advert text, jobs.ch's translation with the source language, published salary (only when the advertiser states one), employment type, weekly hours, industry, category, skills, application method and link, and closing date. Charged as a job detail instead of a job listing. Job page URLs always include full details.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of jobs to save.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach jobs.ch. The default works for most runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }