{
  "openapi": "3.0.1",
  "info": {
    "title": "StepStone Jobs Scraper API — 18 Portals, Salaries & Contacts",
    "description": "Collect jobs across 18 StepStone Group portals, including Germany, Austria, Belgium, Netherlands, UK, Ireland and South Africa. Salary estimates with provenance, full advert sections, public recruiter contacts, employer profiles and new/updated-job feeds.",
    "version": "0.1",
    "x-build-id": "NndnDH2nt54B9xIiQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trakk~stepstone-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trakk-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/trakk~stepstone-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-trakk-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/trakk~stepstone-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-trakk-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": {
          "keywords": {
            "title": "🔍 Job keyword(s)",
            "type": "array",
            "description": "One or more job searches, for example software developer, data engineer, product manager.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "City or region slug, for example berlin, munich, deutschland. Leave empty for all locations."
          },
          "maxItems": {
            "title": "💯 Number of jobs to extract",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Total unique jobs saved across all searches and direct URLs. Duplicates, filtered and unchanged jobs do not consume this limit. 0 collects until source/page limits, with a 100,000 saved-job safety ceiling.",
            "default": 5
          },
          "mode": {
            "title": "🧭 Input type",
            "enum": [
              "AUTO",
              "SEARCH",
              "URLS",
              "DETAILS"
            ],
            "type": "string",
            "description": "AUTO detects whether you provided keyword searches or StepStone URLs.",
            "default": "AUTO"
          },
          "country": {
            "title": "🌍 StepStone country",
            "enum": [
              "DE",
              "AT",
              "BE",
              "NL",
              "TOTALJOBS",
              "CWJOBS",
              "JOBSITE",
              "MILKROUND",
              "CATERER",
              "RETAILCHOICE",
              "CATERERGLOBAL",
              "CAREERSTRUCTURE",
              "CITYJOBS",
              "JUSTENGINEERS",
              "EMEDCAREERS",
              "NIJOBS",
              "JOBSIE",
              "PNET"
            ],
            "type": "string",
            "description": "Portal used for generated searches. Job links may point to a partner portal; direct URLs retain their original country and currency.",
            "default": "DE"
          },
          "includeDetails": {
            "title": "📄 Include full job details",
            "type": "boolean",
            "description": "Add descriptions, separate tasks/requirements/benefits, salary provenance, address, coordinates and employer information where the public job page provides them.",
            "default": false
          },
          "includeContacts": {
            "title": "📞 Extract public contacts",
            "type": "boolean",
            "description": "Read job pages and extract public contacts from the advert itself; navigation and unrelated footer contacts are excluded.",
            "default": false
          },
          "includeCompany": {
            "title": "🏢 Enrich company profile",
            "type": "boolean",
            "description": "Request each public employer profile once per run, preserving employer information already present on job pages.",
            "default": false
          },
          "startUrls": {
            "title": "🔗 StepStone URL(s)",
            "type": "array",
            "description": "StepStone search URLs, work URLs, or direct job URLs. AUTO mode detects how to use them.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "postedWithin": {
            "title": "🕒 Posted within",
            "enum": [
              "all",
              "1d",
              "3d",
              "7d",
              "14d",
              "30d"
            ],
            "type": "string",
            "description": "Applied to source timestamps as well as the search URL. Missing timestamps cannot pass an active date filter.",
            "default": "all"
          },
          "remoteOnly": {
            "title": "🏠 Remote only",
            "type": "boolean",
            "description": "Keep jobs with a source home-office/remote signal, including hybrid. Use workModels to request a specific model. Missing list signals may require the job page.",
            "default": false
          },
          "salaryOnly": {
            "title": "💰 Salary only",
            "type": "boolean",
            "description": "Keep published numeric salaries, including clearly labelled StepStone estimates. Reads job pages when list data is insufficient; result price stays the same, platform usage may increase.",
            "default": false
          },
          "excludeRecommended": {
            "title": "Skip recommended padding",
            "type": "boolean",
            "description": "Drop recommended jobs that StepStone may add when a filtered page has too few exact matches.",
            "default": true
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 1,
            "maximum": 400,
            "type": "integer",
            "description": "Maximum pages fetched per search, starting at the page in a pasted URL. Stops earlier at saved-result or spending limits, or source exhaustion. Filtered jobs do not consume maxItems.",
            "default": 400
          },
          "outputMode": {
            "title": "📦 Output style",
            "enum": [
              "compact",
              "full"
            ],
            "type": "string",
            "description": "Compact returns clean normalized fields. Full keeps more StepStone native fields.",
            "default": "compact"
          },
          "rawOutput": {
            "title": "Include raw payload",
            "type": "boolean",
            "description": "Attach the raw StepStone job object under _raw for debugging or custom pipelines.",
            "default": false
          },
          "debugLog": {
            "title": "Debug log",
            "type": "boolean",
            "description": "Save a small HTML/API debug sample to the key-value store when parsing fails. Keep off for normal runs.",
            "default": false
          },
          "maxConcurrency": {
            "title": "⚙️ Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many HTTP requests may run in parallel.",
            "default": 8
          },
          "maxRetries": {
            "title": "Max retries",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Retries for HTTP 403, 408, 425, 429, 5xx and parse failures.",
            "default": 4
          },
          "maxProxyRetries": {
            "title": "Max proxy retries",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Dedicated proxy / transport retry budget per request.",
            "default": 4
          },
          "requestDelayMs": {
            "title": "Request delay",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Optional delay before each request. Keep 0 for fastest runs.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy configuration. Residential Germany is recommended because StepStone is geo-sensitive.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "DE"
            }
          },
          "keyword": {
            "title": "Legacy single keyword",
            "type": "string",
            "description": "Hidden compatibility field for old tasks that used one keyword string.",
            "default": ""
          },
          "locations": {
            "title": "📍 Multiple locations",
            "type": "array",
            "description": "Each keyword is combined with every location. Legacy location is also accepted.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sortBy": {
            "title": "Sort results",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "Sort generated keyword searches. Pasted URLs keep their own sort order.",
            "default": "relevance"
          },
          "radiusKm": {
            "title": "Search radius (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Radius around the location for generated keyword searches.",
            "default": 30
          },
          "matchTypes": {
            "title": "Source match types",
            "type": "array",
            "description": "StepStone search section: main/exact, semantic/similar, regional/nearby or recommended. These are source classifications, not literal title equality. Direct job URLs have no search match classification.",
            "items": {
              "type": "string",
              "enum": [
                "exact",
                "similar",
                "nearby",
                "recommended",
                "unknown"
              ]
            },
            "default": []
          },
          "workModels": {
            "title": "Work models",
            "type": "array",
            "description": "Only source-confirmed models pass. remote_or_hybrid means the advert mentions home office without specifying the split.",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite",
                "remote_or_hybrid"
              ]
            },
            "default": []
          },
          "employmentTypes": {
            "title": "Working schedule",
            "type": "array",
            "description": "Filters source working schedules. May require job details.",
            "items": {
              "type": "string",
              "enum": [
                "FULL_TIME",
                "PART_TIME",
                "CONTRACT",
                "TEMPORARY",
                "INTERN",
                "OTHER"
              ]
            },
            "default": []
          },
          "contractTypes": {
            "title": "Contract labels",
            "type": "array",
            "description": "Exact source contract labels, for example Feste Anstellung or Permanent. Reads job details when needed.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "listingLanguages": {
            "title": "Search language category",
            "type": "array",
            "description": "StepStone native detected-language search category. This can differ from the language declared by the advert; searchLanguageFilters and listingLanguage expose both. Direct URLs use the declared language when no search category is available.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "applicationMethods": {
            "title": "Application method",
            "type": "array",
            "description": "Native search application flow. INTERNAL is StepStone quick apply, EXTERNAL is the employer website.",
            "items": {
              "type": "string",
              "enum": [
                "INTERNAL",
                "EXTERNAL"
              ]
            },
            "default": []
          },
          "titleInclude": {
            "title": "Title includes",
            "type": "array",
            "description": "Keep titles containing at least one of these phrases, case-insensitive.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "titleExclude": {
            "title": "Title excludes",
            "type": "array",
            "description": "Drop titles containing any of these phrases before a result is charged.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "companyInclude": {
            "title": "Employer includes",
            "type": "array",
            "description": "Keep employer names containing at least one phrase.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "companyExclude": {
            "title": "Employer excludes",
            "type": "array",
            "description": "Drop matching employer names.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "skipJobIds": {
            "title": "Skip job IDs",
            "type": "array",
            "description": "Ignore known job IDs without consuming result slots.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "excludeSponsored": {
            "title": "Exclude sponsored jobs",
            "type": "boolean",
            "description": "Drop source-marked sponsored postings.",
            "default": false
          },
          "includeSalaryEstimates": {
            "title": "Include salary estimates",
            "type": "boolean",
            "description": "Keep StepStone predictions, clearly labelled salaryIsEstimate=true. Turn off to remove predicted salaries.",
            "default": true
          },
          "minYearlySalary": {
            "title": "Minimum yearly salary",
            "minimum": 0,
            "type": "number",
            "description": "Compares the lower/upper stated yearly bound in the recorded currency. Monthly pay uses ×12 and excludes extra payments; hourly/weekly figures are not guessed into annual amounts. Job pages are requested if necessary."
          },
          "maxYearlySalary": {
            "title": "Maximum yearly salary",
            "minimum": 0,
            "type": "number",
            "description": "Compares the lower/upper stated yearly bound in the recorded currency. Monthly pay uses ×12 and excludes extra payments; hourly/weekly figures are not guessed into annual amounts. Job pages are requested if necessary."
          },
          "salaryCurrencies": {
            "title": "Salary currencies",
            "type": "array",
            "description": "Restrict comparisons to source currencies; exchange rates are not applied.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "onlyNewerThan": {
            "title": "Published after",
            "type": "string",
            "description": "Exclusive publication cutoff: ISO-8601, Unix seconds or milliseconds. Not an update timestamp. Missing timestamps do not pass. Future dates are rejected."
          },
          "includeDescriptionHtml": {
            "title": "Include description HTML",
            "type": "boolean",
            "description": "Keep full advert HTML alongside the text when details are requested.",
            "default": true
          },
          "includeHiringInsights": {
            "title": "📊 Employer hiring summary",
            "type": "boolean",
            "description": "Build a separate Companies dataset with collected roles, locations, public contacts, salary bands and honest collection scope. It does not create extra job-result events.",
            "default": false
          },
          "incrementalMode": {
            "title": "Repeat-run output",
            "enum": [
              "off",
              "new_only",
              "new_and_updated"
            ],
            "type": "string",
            "description": "Use a persistent per-user stateKey to skip previously delivered jobs. Only saved jobs update the feed state. Concurrent runs sharing a key may overlap.",
            "default": "off"
          },
          "stateKey": {
            "title": "Feed identifier",
            "type": "string",
            "description": "Use a separate identifier for independent feeds. State is scoped to the authenticated user and Actor.",
            "default": "default"
          },
          "sourceContractIds": {
            "title": "Native contract IDs",
            "type": "array",
            "description": "Advanced generated-search facet IDs copied from a current portal search URL. IDs vary by portal; pasted URLs can carry all native filters.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sourceExperienceIds": {
            "title": "Native experience IDs",
            "type": "array",
            "description": "Advanced generated-search facet IDs copied from a current portal search URL. IDs vary by portal; pasted URLs can carry all native filters.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sourceIndustryIds": {
            "title": "Native sector IDs",
            "type": "array",
            "description": "Advanced generated-search facet IDs copied from a current portal search URL. IDs vary by portal; pasted URLs can carry all native filters.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sourceSkillIds": {
            "title": "Native skill IDs",
            "type": "array",
            "description": "Advanced generated-search facet IDs copied from a current portal search URL. IDs vary by portal; pasted URLs can carry all native filters.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sourceRegionIds": {
            "title": "Native region IDs",
            "type": "array",
            "description": "Advanced generated-search facet IDs copied from a current portal search URL. IDs vary by portal; pasted URLs can carry all native filters.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "adLanguages": {
            "title": "Declared advert language",
            "type": "array",
            "description": "Strictly match the advert offerLanguage/inLanguage code, such as en. Can require many job pages because native search language categories may include ads declared in another language. Use a small maxPagesPerSearch sample first.",
            "items": {
              "type": "string"
            },
            "default": []
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}