{ "openapi": "3.0.1", "info": { "title": "StepStone Jobs Scraper", "description": "Scrape StepStone.de job listings — salary range, skills, apply URLs, company data — by keyword, location, Bundesland, or radius. 100% run success, incremental monitoring, compact LLM mode, flat $1.20/1K, no monthly fee.", "version": "1.0", "x-build-id": "vGvmhKIMs0paKV1ee" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/intelscrape~stepstone-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-intelscrape-stepstone-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/intelscrape~stepstone-scraper/runs": { "post": { "operationId": "runs-sync-intelscrape-stepstone-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/intelscrape~stepstone-scraper/run-sync": { "post": { "operationId": "run-sync-intelscrape-stepstone-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", "required": [ "location" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "The job title, keyword, or company (e.g. 'Software Developer'). Leave blank to scrape all jobs in the location." }, "location": { "title": "Location (City)", "enum": [ "Berlin", "Hamburg", "Munich", "Frankfurt am Main", "Cologne", "Düsseldorf", "Stuttgart", "Hanover", "Leipzig", "Bremen", "Dresden", "Nuremberg", "Dortmund", "Essen", "Münster", "Karlsruhe", "Mannheim", "Bonn", "Augsburg", "Kassel", "Potsdam", "Grünheide (Mark)", "Ludwigsfelde", "Schönefeld", "Eberswalde", "Oranienburg", "Falkensee", "Großbeeren", "Königs Wusterhausen", "Teltow", "Hennigsdorf", "Blankenfelde", "Nauen", "Strausberg", "Mahlow", "Werder (Havel)", "Kleinmachnow", "Fürstenwalde/Spree", "Velten" ], "type": "string", "description": "Select the target German city.", "default": "Berlin" }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Maximum number of jobs to extract (e.g. 5000 to extract an entire city). Stepstone typically caps pagination at a few thousand jobs." }, "mode": { "title": "Run Mode", "enum": [ "full", "incremental" ], "type": "string", "description": "full: scrape all jobs. incremental: scrape only jobs that are new or updated since the last run (saves money).", "default": "full" }, "emitUnchanged": { "title": "Emit Unchanged Jobs (Incremental Mode)", "type": "boolean", "description": "If true, unchanged jobs will still be pushed to the dataset (and billed) during an incremental run.", "default": false }, "compactOutput": { "title": "Compact Output (LLM Mode)", "type": "boolean", "description": "If true, emits a simplified, token-cheap JSON object ideal for feeding directly into LLM agents.", "default": false }, "notifyWebhookUrl": { "title": "Notify Webhook URL", "type": "string", "description": "Optional webhook URL to POST a summary of new/updated jobs to after the run finishes (Slack/Discord/Make.com)." } } }, "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 } } } } } } } } } }