{
  "openapi": "3.0.1",
  "info": {
    "title": "StepStone.de Jobs Scraper: Contacts, Benefits & Filters",
    "description": "Find and monitor German job postings from StepStone.de for recruiting, market research and lead generation: title, company, location, salary when stated, requirements, benefits and contact details.",
    "version": "2.4",
    "x-build-id": "s3ulqzc8lmGF2D4C6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/santamaria-automations~stepstone-de-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-santamaria-automations-stepstone-de-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/santamaria-automations~stepstone-de-scraper/runs": {
      "post": {
        "operationId": "runs-sync-santamaria-automations-stepstone-de-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/santamaria-automations~stepstone-de-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-santamaria-automations-stepstone-de-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": {
          "searchUrls": {
            "title": "Search page URLs from stepstone.de",
            "type": "array",
            "description": "Paste search result page URLs copied from stepstone.de to keep every filter you set on the site, such as industry, region, experience or skills. Each URL is read page by page. The jobs are combined with the keyword searches below and duplicates are removed. Plain URLs or objects with a url field are accepted.",
            "items": {
              "type": "string",
              "pattern": "^https://www\\.stepstone\\.de/"
            }
          },
          "directUrls": {
            "title": "Job page URLs",
            "type": "array",
            "description": "Links to single StepStone job ads that you want to read or check, for example to see if a job is still online. When you fill this in, the search settings are ignored. Plain URLs or objects with a url field are accepted.",
            "items": {
              "type": "string",
              "pattern": "^https://www\\.stepstone\\.de/"
            }
          },
          "searchQueries": {
            "title": "Job titles or keywords",
            "type": "array",
            "description": "One or more job titles or keywords, for example Softwareentwickler or Pflegefachkraft. Each keyword is searched on its own and duplicate jobs are removed.",
            "items": {
              "type": "string"
            }
          },
          "searchQuery": {
            "title": "Job title or keyword (single)",
            "type": "string",
            "description": "One job title or keyword. Kept for older setups; use the list of job titles or keywords to search for several at once."
          },
          "location": {
            "title": "City or region",
            "type": "string",
            "description": "City, region or federal state to search in, for example Berlin, München, Sachsen or Frankfurt am Main. If you fill this in, it is used instead of the federal state list."
          },
          "radius": {
            "title": "Search radius in km",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "How far around the city to search, in kilometers. Use 0, 5, 10, 25, 50, 100, 150 or 200.",
            "default": 25
          },
          "bundesland": {
            "title": "Federal state",
            "enum": [
              "",
              "BY",
              "BW",
              "BE",
              "BB",
              "HB",
              "HH",
              "HE",
              "MV",
              "NI",
              "NW",
              "RP",
              "SL",
              "SN",
              "ST",
              "SH",
              "TH"
            ],
            "type": "string",
            "description": "Only look for jobs in one German federal state. Used only when the city or region field is empty.",
            "default": ""
          },
          "employmentType": {
            "title": "Employment type",
            "enum": [
              "",
              "FULL_TIME",
              "PART_TIME",
              "INTERNSHIP",
              "TRAINEE",
              "TEMPORARY",
              "CONTRACT"
            ],
            "type": "string",
            "description": "Full-time or part-time work, or a contract form such as internship, trainee, temporary or freelance. Leave empty for all types. For working students or apprenticeships use the StepStone contract types below.",
            "default": ""
          },
          "stepstoneContractTypes": {
            "title": "StepStone contract types",
            "type": "array",
            "description": "Extra StepStone contract types, such as working student, apprenticeship or permanent position. You can pick several. They are combined with the employment type above, so a job matching either one is returned. For more filters, such as industry or region, paste a search page URL instead.",
            "items": {
              "type": "string",
              "enum": [
                "PERMANENT",
                "WERKSTUDENT",
                "AUSBILDUNG",
                "HANDELSVERTRETER",
                "ARBEITNEHMERUEBERLASSUNG",
                "FRANCHISE"
              ],
              "enumTitles": [
                "Feste Anstellung - ct=222",
                "Werkstudent / Studentenjobs - ct=229",
                "Ausbildung / Studium - ct=226",
                "Handelsvertreter - ct=232",
                "Arbeitnehmerueberlassung - ct=220",
                "Franchise - ct=221"
              ]
            },
            "default": []
          },
          "experienceLevel": {
            "title": "Experience level",
            "enum": [
              "",
              "ENTRY_LEVEL",
              "PROFESSIONAL",
              "MANAGEMENT",
              "EXECUTIVE"
            ],
            "type": "string",
            "description": "Only return jobs for one career level, from entry level to executive. Leave empty for all levels.",
            "default": ""
          },
          "postedWithinDays": {
            "title": "Posted in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs that were posted in the last N days. Use 1 for the last 24 hours and 7 for the last week. 0 means no age filter. Use this for daily or weekly schedules.",
            "default": 0
          },
          "datePosted": {
            "title": "Posted within (older setting)",
            "enum": [
              "",
              "1",
              "7",
              "30"
            ],
            "type": "string",
            "description": "Older way to filter by age: last 24 hours, 7 days or 30 days. Use the number of days field above for new setups.",
            "default": ""
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "newest",
              "relevance"
            ],
            "type": "string",
            "description": "Show the newest jobs first or the most relevant jobs first. Newest first is best for scheduled runs. The value date is also accepted and means newest first.",
            "default": "newest"
          },
          "titleFilter": {
            "title": "Only keep jobs with this in the title",
            "type": "string",
            "description": "Keep only jobs whose title contains this text, ignoring upper and lower case. Separate several phrases with commas to match any of them, for example Sales Manager, Account Executive. StepStone also returns jobs that only mention your keyword in the text, so this narrows the list to real title matches. Leave empty to keep everything.",
            "default": ""
          },
          "maxResultsPerQuery": {
            "title": "Max jobs per keyword",
            "minimum": 0,
            "type": "integer",
            "description": "Most jobs to return for each keyword or search URL. Ten keywords with 100 each can give up to 1000 jobs. 0 means no limit per keyword. When a title filter is on, only jobs that pass the filter are counted.",
            "default": 100
          },
          "maxResults": {
            "title": "Max jobs in total",
            "minimum": 0,
            "type": "integer",
            "description": "Most jobs to return over all keywords together. 0 means no overall limit, so only the per-keyword limit applies.",
            "default": 0
          },
          "includeJobDetails": {
            "title": "Include full job details",
            "type": "boolean",
            "description": "When on (recommended), each job page is opened to get the full description, requirements, benefits, salary, contact details and apply link. When off, you only get what the search results show: title, company, location, short text, date and salary text if shown. Off is cheaper and faster.",
            "default": true
          },
          "maxPagesFetched": {
            "title": "Max search pages per keyword",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Safety limit on how many result pages are read for each keyword. One page holds up to 25 jobs, so the default of 10 reads up to 250 results per keyword. Raise it when a title filter drops most results.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}