{
"openapi": "3.0.1",
"info": {
"title": "StepStone Jobs Scraper",
"description": "Scrape StepStone.de jobs in Germany by keyword and city: title, company, location, remote, contract type, full description, benefits, industry and apply link. All StepStone filters and alerts.",
"version": "0.1",
"x-build-id": "WFCaWlqKLnQ6MnNhg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/robertosan16~stepstone-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-robertosan16-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/robertosan16~stepstone-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-robertosan16-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/robertosan16~stepstone-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-robertosan16-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": {
"searchQueries": {
"title": "Job titles or keywords",
"type": "array",
"description": "What to search, for example Softwareentwickler, data analyst or Pflege. Each line is a separate search with the filters below. You can also paste links of searches from stepstone.de.",
"items": {
"type": "string"
}
},
"location": {
"title": "Location",
"type": "string",
"description": "A city or region, for example Berlin, München or Frankfurt am Main. Leave empty for all of Germany."
},
"radius": {
"title": "Distance around the location",
"minimum": 0,
"type": "integer",
"description": "Also find jobs this far from the location, for example 30."
},
"contractTypes": {
"title": "Contract type",
"type": "array",
"description": "Leave empty for all.",
"items": {
"type": "string",
"enum": [
"220",
"222",
"223",
"224",
"225",
"226",
"227",
"228",
"229",
"230"
],
"enumTitles": [
"Temporary agency work",
"Permanent",
"Fixed-term",
"Entry level or trainee",
"Freelance or project",
"Apprenticeship or dual study",
"Thesis (bachelor, master)",
"Internship",
"Working student",
"PhD or habilitation"
]
}
},
"workTypes": {
"title": "Working hours",
"type": "array",
"description": "Leave empty for all.",
"items": {
"type": "string",
"enum": [
"vollzeit",
"teilzeit"
],
"enumTitles": [
"Full-time",
"Part-time"
]
}
},
"remoteTypes": {
"title": "Home office",
"type": "array",
"description": "Leave empty for all jobs, including on-site ones.",
"items": {
"type": "string",
"enum": [
"1",
"2"
],
"enumTitles": [
"Fully remote",
"Partly from home"
]
}
},
"experience": {
"title": "Experience",
"type": "array",
"description": "Leave empty for all.",
"items": {
"type": "string",
"enum": [
"90001",
"90002",
"90003"
],
"enumTitles": [
"No experience needed",
"With experience",
"With management responsibility"
]
}
},
"languages": {
"title": "Job ad language",
"type": "array",
"description": "Only jobs written in these languages. Pick English for jobs where English is enough.",
"items": {
"type": "string",
"enum": [
"de",
"en"
],
"enumTitles": [
"German",
"English"
]
}
},
"postedWithinDays": {
"title": "Posted in the last days",
"minimum": 0,
"type": "integer",
"description": "Keep jobs published in the last N days: 1 means today and yesterday. Leave empty or 0 for any date."
},
"sortBy": {
"title": "Sort by",
"enum": [
"date",
"relevance"
],
"type": "string",
"description": "Newest first suits job alerts. Links you paste keep their own order.",
"default": "date"
},
"excludeKeywords": {
"title": "Exclude title keywords",
"type": "array",
"description": "Skip jobs whose title contains any of these, for example intern or senior. Common word endings are included.",
"items": {
"type": "string"
}
},
"keywords": {
"title": "Title must contain",
"type": "array",
"description": "Keep only jobs whose title contains any of these words or phrases. StepStone searches descriptions too, so this makes results stricter. Add * for any ending: data*.",
"items": {
"type": "string"
}
},
"onlyWithSalary": {
"title": "Only jobs with a salary",
"type": "boolean",
"description": "Keep only jobs that state a pay range or rate.",
"default": false
},
"onlyNew": {
"title": "Only new jobs since the last run",
"type": "boolean",
"description": "For scheduled runs: save only jobs that were not seen in earlier runs of the same saved task. The first run saves all current jobs and remembers them. Jobs that did not match your filters are remembered too.",
"default": false
},
"includeDescription": {
"title": "Load full job details",
"type": "boolean",
"description": "Open each job page for the full description (text and HTML), employment type, industry and expiry date. Turn off for fast results with a short summary instead.",
"default": true
},
"maxItems": {
"title": "Maximum jobs in total",
"minimum": 0,
"type": "integer",
"description": "Stop after saving this many jobs. Leave empty or 0 for no limit. The example is kept small so the first run takes seconds."
},
"maxItemsPerCompany": {
"title": "Maximum jobs per search",
"minimum": 0,
"type": "integer",
"description": "Save at most this many jobs from each search. Leave empty or 0 for no limit."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "The Actor connects directly, which is fastest. If StepStone starts limiting requests, it switches to Apify Proxy automatically. Turn on a proxy here only to use it from the start.",
"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
}
}
}
}
}
}
}
}
}
}