{
"openapi": "3.0.1",
"info": {
"title": "StepStone Scraper - Germany Job Listings",
"description": "Scrape job listings from stepstone.de search URLs: title, company, location, posting date, remote option, benefits, quick-apply flag and job link. Exact matches by default, StepStone filters carried through, many pages per search. Independent tool, not affiliated with StepStone.",
"version": "0.1",
"x-build-id": "KPt90s8wdFPVB0PET"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~stepstone-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~stepstone-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~stepstone-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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",
"properties": {
"startUrls": {
"title": "stepstone.de search URLs",
"type": "array",
"description": "stepstone.de job-search URLs, one per line. Run a search on stepstone.de (keyword, city, and any filters such as home office, posted in the last 24 hours or contract type), then paste the URL from your browser. Single job-posting pages (/stellenangebote--...) are skipped at no cost. Leave empty and the run returns a small sample.",
"items": {
"type": "string"
}
},
"startUrlsFromFile": {
"title": "Import URLs from a file",
"type": "string",
"description": "Bulk-load stepstone.de search URLs. Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"maxPagesPerUrl": {
"title": "Max pages per URL",
"minimum": 1,
"type": "integer",
"description": "How many result pages to read per search URL (25 jobs per page). The run stops earlier on its own once a search's exact matches run out.",
"default": 5
},
"maxItems": {
"title": "Max jobs (total)",
"minimum": 1,
"type": "integer",
"description": "Overall cap across all URLs. You are only charged for jobs actually saved.",
"default": 1000
},
"includeSuggestions": {
"title": "Include StepStone's suggestions",
"type": "boolean",
"description": "After the exact matches for your search, StepStone appends extra suggestions: loosely related jobs and jobs in nearby towns, often in completely different roles. They are left out by default, so you only pay for real matches. Turn this on to scrape everything StepStone lists; each row's matchType says whether it is an exact match, a related suggestion or a nearby-town suggestion.",
"default": false
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports.",
"items": {
"type": "string",
"enum": [
"type",
"id",
"title",
"url",
"company",
"location",
"salary",
"workModel",
"postedDate",
"teaser",
"companyLogo",
"sourceUrl",
"scrapedAt",
"datePosted",
"matchType",
"position",
"remoteOption",
"companyId",
"companyUrl",
"quickApply",
"noCoverLetter",
"labels",
"benefits",
"salaryEstimateMin",
"salaryEstimateMax",
"salaryEstimateCurrency",
"salaryEstimatePeriod"
],
"enumTitles": [
"Record type (type)",
"Id (id)",
"Title (title)",
"URL (url)",
"Company (company)",
"Location (location)",
"Salary (salary)",
"Work model (workModel)",
"Posted (postedDate)",
"Teaser (teaser)",
"Company logo (companyLogo)",
"Source URL (sourceUrl)",
"Scraped at (scrapedAt)",
"Date posted (datePosted)",
"Match type (matchType)",
"Position in results (position)",
"Remote option (remoteOption)",
"Company id (companyId)",
"Company page (companyUrl)",
"Quick apply (quickApply)",
"No cover letter (noCoverLetter)",
"Labels (labels)",
"Benefits (benefits)",
"Salary estimate min (salaryEstimateMin)",
"Salary estimate max (salaryEstimateMax)",
"Salary estimate currency (salaryEstimateCurrency)",
"Salary estimate period (salaryEstimatePeriod)"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}