{ "openapi": "3.0.1", "info": { "title": "jobs.ch Jobs, With the Place the Data Layer Drops", "description": "Swiss job adverts from jobs.ch with the exact posting time, the workload percentage and the workplace as the site wrote it. The page's own data layer leaves the place empty on a third of adverts and invents the advert text, so this reads both surfaces and keeps the one that is true.", "version": "0.1", "x-build-id": "WzN4qREu50BfyzaKp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~jobsch-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-jobsch-jobs", "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/gubidonius~jobsch-jobs/runs": { "post": { "operationId": "runs-sync-gubidonius-jobsch-jobs", "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/gubidonius~jobsch-jobs/run-sync": { "post": { "operationId": "run-sync-gubidonius-jobsch-jobs", "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": { "term": { "title": "Search", "type": "string", "description": "Job title, skill or keyword. The jobs.ch search is semantic rather than substring, so \"engineer\" returns 1,459 adverts and \"e\" returns 182, not everything containing the letter. Leave it empty to search the whole board under the filters below.", "default": "" }, "location": { "title": "Place", "type": "string", "description": "A place name such as zurich, geneva, basel or lausanne. Case does not matter. This is the one place filter jobs.ch accepts as a word rather than an id.", "default": "" }, "region": { "title": "Region id", "type": "string", "description": "One of the 15 region ids jobs.ch uses, as a number: 2 German part of Switzerland, 3 Western Switzerland, 4 Ticino, 5 Abroad, 6 Geneva, 7 Zurich / Schaffhausen, 8 Neuchâtel / Jura, 9 Fribourg, 10 Vaud / Valais, 11 Eastern Switzerland / GR / FL, 12 Mittelland (AG / SO), 13 Bern, 14 Basel, 15 Central Switzerland, 16 Oberwallis. A name instead of a number stops the run rather than returning the whole board unfiltered.", "default": "" }, "category": { "title": "Occupational field id", "type": "string", "description": "A numeric occupational-field id, for example 97. jobs.ch publishes 165 of them in its own sitemap. A name instead of a number stops the run.", "default": "" }, "industry": { "title": "Industry id", "type": "string", "description": "A numeric industry id from 1 to 24. A name instead of a number stops the run.", "default": "" }, "employmentType": { "title": "Contract type id", "type": "string", "description": "Contract type as a number: 1 Temporary, 2 Freelance, 3 Internship, 4 Supplementary income, 5 Permanent position, 6 Apprenticeship. A name instead of a number stops the run.", "default": "" }, "publishedWithinDays": { "title": "Published within days", "minimum": 0, "type": "integer", "description": "Only adverts published in the last N days. 0 means no date filter. This is the cheapest way to run the Actor as a change feed: run it daily with 1 and compare on jobId.", "default": 0 }, "maxResults": { "title": "Maximum adverts", "minimum": 1, "type": "integer", "description": "How many adverts to return at most. The budget is global and checked after deduplication, so a duplicate never uses a paid slot. A single jobs.ch search serves at most 100 pages, about 2,000 to 2,200 adverts, whatever its total says. Ask for more than that and the search is cut into the site's own regions to reach the rest.", "default": 100 } } }, "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 } } } } } } } } } }