{ "openapi": "3.0.1", "info": { "title": "JobScout24.ch Jobs Scraper", "description": "Scrape job listings from JobScout24.ch by keyword, region, category, and contract type. Get title, company, location, canton, workload, employment type, full description, and more. Export as JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "v1rZQGANoRKpfMfQu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~jobscout24-ch-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-jobscout24-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/parsebird~jobscout24-ch-jobs-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-jobscout24-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/parsebird~jobscout24-ch-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-jobscout24-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Job titles or keywords. Each keyword runs a separate search; results are merged and de-duplicated. Up to 50 keywords.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "A Swiss city or town (e.g. Zürich, Bern, Geneva, Basel). Matched against each job's own listed location after fetching. Leave empty to search all of Switzerland." }, "region": { "title": "Region", "enum": [ "", "1", "2", "3", "13", "4", "5", "6", "7", "8", "9", "10", "11", "14" ], "type": "string", "description": "Named Swiss region (canton group). Matched against each job's canton after fetching its detail page — automatically turns on 'Fetch full job details' if it is off.", "default": "" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste JobScout24.ch search-result or individual job URLs directly. Overrides the keyword, location, and region fields above.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "22", "23", "24", "21" ], "type": "string", "description": "One professional category (Berufsgruppe).", "default": "" }, "employmentType": { "title": "Contract types", "type": "array", "description": "Contract types to keep. Leave empty for all.", "items": { "type": "string", "enum": [ "permanent", "temporary", "internship", "freelance", "part-time", "apprenticeship" ], "enumTitles": [ "Permanent position", "Temporary / fixed-term", "Internship / trainee", "Freelance", "Part-time", "Apprenticeship (Lehrstelle)" ] }, "default": [] }, "workloadMin": { "title": "Min workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep jobs offering at least this workload percentage (Pensum), 0–100. Applied after fetching." }, "workloadMax": { "title": "Max workload (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep jobs offering at most this workload percentage (Pensum), 0–100." }, "publishedSince": { "title": "Published within", "enum": [ "", "1", "3", "7", "30" ], "type": "string", "description": "Only return jobs posted within this window.", "default": "" }, "language": { "title": "Site language", "enum": [ "en", "de", "fr" ], "type": "string", "description": "Language for job titles and descriptions.", "default": "en" }, "maxResults": { "title": "Max results per keyword", "minimum": 0, "type": "integer", "description": "Maximum jobs per search keyword (0 = collect every match). The last page is kept in full, so the count can slightly overshoot.", "default": 100 }, "includeJobDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Fetch the full description and detail-page fields (canton, employment type, exact workload, full description, company logo/URL) for each job. Turn off for a faster, lighter scan of summary fields only.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. JobScout24.ch works well without a proxy; add one for higher reliability on large 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 } } }, "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 } } } } } } } } } }