{ "openapi": "3.0.1", "info": { "title": "StepStone & PNet Jobs Scraper (5 Countries)", "description": "Scrape job listings from StepStone Germany, Austria, Belgium, Netherlands and PNet South Africa in one run: title, company, location, salary, home office, posting date, benefits and full description with address and coordinates.", "version": "1.0", "x-build-id": "MUMGZYtWhqAvTOzQL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kirozhang~stepstone-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kirozhang-stepstone-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/kirozhang~stepstone-jobs-scraper/runs": { "post": { "operationId": "runs-sync-kirozhang-stepstone-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/kirozhang~stepstone-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-kirozhang-stepstone-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": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Job titles, skills or companies, e.g. \"data analyst\", \"Pflegefachkraft\", \"Buchhalter\", \"software engineer\". Each keyword runs on every selected job board. Leave empty to scrape all jobs (optionally in a location).", "items": { "type": "string" } }, "sites": { "title": "Job boards", "type": "array", "description": "StepStone Germany, Austria, Belgium, Netherlands and PNet South Africa. All return the same clean output; each keyword runs on every selected board.", "items": { "type": "string", "enum": [ "stepstone.de", "stepstone.at", "stepstone.be", "stepstone.nl", "pnet.co.za" ], "enumTitles": [ "StepStone Germany (stepstone.de)", "StepStone Austria (stepstone.at)", "StepStone Belgium (stepstone.be)", "StepStone Netherlands (stepstone.nl)", "PNet South Africa (pnet.co.za)" ] }, "default": [ "stepstone.de" ] }, "location": { "title": "Location", "type": "string", "description": "Optional city or region as you would type it on the site, e.g. \"Berlin\", \"München\", \"Wien\", \"Brussels\", \"Amsterdam\", \"Cape Town\"." }, "radius": { "title": "Radius around location", "minimum": 0, "maximum": 200, "type": "integer", "description": "Optional search radius in km around the location. Leave empty for the site default." }, "postedWithinDays": { "title": "Posted within", "enum": [ "0", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only jobs posted within this many days.", "default": "0" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of results.", "default": "relevance" }, "maxJobsPerSearch": { "title": "Max jobs per keyword and board", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to save for each keyword on each board (and for each start URL).", "default": 100 }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Open every job ad and add the full description (text + HTML), employment type, industry, expiry date, street address and coordinates. Charged as an extra event only when the description is returned.", "default": false }, "startUrls": { "title": "Search URLs (optional)", "type": "array", "description": "Paste search result URLs from StepStone or PNet with the site's own filters applied (contract type, experience, home office, industry, company, …). Each URL is paged through up to \"Max jobs\". When used without keywords, the job boards list above is ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed: the Actor connects directly and automatically switches a board to residential proxy if that board starts blocking. Set a proxy here only if you want to force one.", "default": { "useApifyProxy": 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 } } } } } } } } } }