{ "openapi": "3.0.1", "info": { "title": "jobs.ch Scraper", "description": "Swiss job ads from jobs.ch with the workload in percent, contract type, canton and the full description. Search in German, French or English by keyword and town, filter by workload or contract, or paste a jobs.ch search link.", "version": "0.1", "x-build-id": "jnl2tycM0RT2XZ8mZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~jobs-ch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-jobs-ch-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/deriverge~jobs-ch-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-jobs-ch-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/deriverge~jobs-ch-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-jobs-ch-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": "Keywords", "type": "array", "description": "What to search for, as in the jobs.ch search box: a job title, skill or company, in German, French or English, for example \"Pflege\", \"Buchhaltung\", \"comptable\" or \"data engineer\". Each keyword is its own search. Leave empty for all jobs.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Swiss cities, towns or postcodes, for example Zürich, Bern, Geneva, Basel, Lausanne or 8001. Each location is its own search. Leave empty for all of Switzerland.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 100, "type": "integer", "description": "jobs.ch search pages have no radius filter, so this value is not applied. jobs.ch decides which nearby places a town search includes." }, "employmentTypes": { "title": "Contract types", "type": "array", "description": "Only jobs with these contract types. Leave empty for all.", "items": { "type": "string", "enum": [ "5", "1", "2", "3", "6", "4" ], "enumTitles": [ "Permanent", "Temporary", "Freelance", "Internship", "Apprenticeship", "Supplementary income" ] } }, "positionLevels": { "title": "Position levels", "type": "array", "description": "Only jobs at these levels. Leave empty for all.", "items": { "type": "string", "enum": [ "3", "2", "1" ], "enumTitles": [ "Employee", "Position with responsibilities", "Executive position" ] } }, "minWorkload": { "title": "Minimum workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only jobs offering at least this workload, for example 80 for 80 to 100% jobs." }, "maxWorkload": { "title": "Maximum workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only jobs you can do at this workload or less, for example 60 for part-time jobs." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the results, as on jobs.ch.", "default": "relevance" }, "language": { "title": "Link language", "enum": [ "en", "de", "fr" ], "type": "string", "description": "Language of the job and company links. Job texts stay in the language the employer wrote them in.", "default": "en" }, "searchUrls": { "title": "Search links from jobs.ch (optional)", "type": "array", "description": "jobs.ch search addresses with your filters, for example https://www.jobs.ch/en/vacancies/?term=python&location=Bern. Each link is its own search.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title or company contains any of these.", "items": { "type": "string" } }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Reads each job page for the full description (text and HTML), street, postcode, city, canton and coordinates, company type, occupation, languages, skills, benefits, expiry date and apply link. The price is the same.", "default": true }, "newOnly": { "title": "Return only jobs new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only jobs that were not there before. Schedule it daily for a job alert.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"pflege-zurich\". Runs from a saved task get one automatically." }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Hard cap on returned jobs. jobs.ch shows up to 2,000 jobs per search. The actor reads one page a second, so 1,000 jobs with full details take about 18 minutes (without details about a minute).", "default": 1000 } } }, "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 } } } } } } } } } }