> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape StepStone job listings

> Searches StepStone (stepstone.de, .at or .be) for `keyword` in `location` and returns `jobs`: `jobId`, `title`, `url`, `companyName`, `companyId`, `companyUrl`, `companyLogo`, `location`, `remote` (partial / full), `salaryMin`/`salaryMax`/`salaryPeriod`/`salaryCurrency` with `salaryType` (predicted or exact), `datePosted`, `validThrough`, `snippet`, `benefits`, `labels`, `noCoverLetter`, `isSponsored`, `isTopJob` and `position`, plus `totalResults`, `pageCount` and `nextPage`. Filter with `radius`, `days`, `remote`, `employment`, `experience`, `contract_type`, `min_salary`, `language` and `apply_method`, sort with `sort`, or pass a StepStone results URL as `search_url`. `details=true` adds `description`, `sections` (introduction, tasks, profile, benefits), `employmentType`, `contractType`, `workType`, `industry`, `address`, `latitude`/`longitude`, `companySectors` and `companyEmployees`. Billed one unit per StepStone page fetched (`callUnits`).



## OpenAPI

````yaml /api-reference/openapi.json post /jobs/stepstone
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /jobs/stepstone:
    post:
      tags:
        - Plugins
      summary: Scrape StepStone job listings
      description: >-
        Searches StepStone (stepstone.de, .at or .be) for `keyword` in
        `location` and returns `jobs`: `jobId`, `title`, `url`, `companyName`,
        `companyId`, `companyUrl`, `companyLogo`, `location`, `remote` (partial
        / full), `salaryMin`/`salaryMax`/`salaryPeriod`/`salaryCurrency` with
        `salaryType` (predicted or exact), `datePosted`, `validThrough`,
        `snippet`, `benefits`, `labels`, `noCoverLetter`, `isSponsored`,
        `isTopJob` and `position`, plus `totalResults`, `pageCount` and
        `nextPage`. Filter with `radius`, `days`, `remote`, `employment`,
        `experience`, `contract_type`, `min_salary`, `language` and
        `apply_method`, sort with `sort`, or pass a StepStone results URL as
        `search_url`. `details=true` adds `description`, `sections`
        (introduction, tasks, profile, benefits), `employmentType`,
        `contractType`, `workType`, `industry`, `address`,
        `latitude`/`longitude`, `companySectors` and `companyEmployees`. Billed
        one unit per StepStone page fetched (`callUnits`).
      operationId: stepstone_jobs_jobs_stepstone_post
      parameters:
        - name: keyword
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Job title, skill or company, e.g. 'python developer' or
              'Pflegefachkraft'.
            title: Keyword
          description: >-
            Job title, skill or company, e.g. 'python developer' or
            'Pflegefachkraft'.
        - name: location
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              City or region, e.g. 'Berlin' or 'München'. Leave empty to search
              the whole country.
            title: Location
          description: >-
            City or region, e.g. 'Berlin' or 'München'. Leave empty to search
            the whole country.
        - name: country
          in: query
          required: false
          schema:
            type: string
            description: >-
              StepStone site: de, at, be (stepstone.de, stepstone.at,
              stepstone.be).
            default: de
            title: Country
          description: >-
            StepStone site: de, at, be (stepstone.de, stepstone.at,
            stepstone.be).
        - name: radius
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: 'Distance around `location` in km: 5, 10, 20, 30, 40, 50, 75, 100.'
            title: Radius
          description: 'Distance around `location` in km: 5, 10, 20, 30, 40, 50, 75, 100.'
        - name: days
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: 'Posting age: 1 or 7 (last 24 hours or last 7 days).'
            title: Days
          description: 'Posting age: 1 or 7 (last 24 hours or last 7 days).'
        - name: remote
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: partial (home office possible) or full (home office only).
            title: Remote
          description: partial (home office possible) or full (home office only).
        - name: employment
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: full_time or part_time.
            title: Employment
          description: full_time or part_time.
        - name: experience
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma list of: none, experienced, manager (no experience, with
              experience, with staff responsibility).
            title: Experience
          description: >-
            Comma list of: none, experienced, manager (no experience, with
            experience, with staff responsibility).
        - name: contract_type
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma list of: permanent, temporary, temp_agency, trainee,
              freelance, apprenticeship, thesis, internship, working_student,
              phd, sales_agent (stepstone.de / .at), or StepStone's numeric
              contract-type ids.
            title: Contract Type
          description: >-
            Comma list of: permanent, temporary, temp_agency, trainee,
            freelance, apprenticeship, thesis, internship, working_student, phd,
            sales_agent (stepstone.de / .at), or StepStone's numeric
            contract-type ids.
        - name: min_salary
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Minimum yearly salary, 10000-100000 in steps of 10000.
            title: Min Salary
          description: Minimum yearly salary, 10000-100000 in steps of 10000.
        - name: language
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Language the ad is written in, comma list of two-letter codes,
              e.g. 'en'.
            title: Language
          description: >-
            Language the ad is written in, comma list of two-letter codes, e.g.
            'en'.
        - name: apply_method
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma list of: company_site, quick_apply (apply on the company's
              site or with StepStone's quick apply).
            title: Apply Method
          description: >-
            Comma list of: company_site, quick_apply (apply on the company's
            site or with StepStone's quick apply).
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: relevance or date (newest first).
            default: relevance
            title: Sort
          description: relevance or date (newest first).
        - name: search_url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A StepStone results page URL to collect instead of
              keyword/location and filters, e.g.
              'https://www.stepstone.de/jobs/data-analyst/in-berlin?radius=30'.
            title: Search Url
          description: >-
            A StepStone results page URL to collect instead of keyword/location
            and filters, e.g.
            'https://www.stepstone.de/jobs/data-analyst/in-berlin?radius=30'.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: 1-based results page to start from; `nextPage` continues.
            default: 1
            title: Page
          description: 1-based results page to start from; `nextPage` continues.
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Jobs to collect, 1-500. Each results page (25 jobs) is billed one
              unit.
            default: 25
            title: Max Results
          description: >-
            Jobs to collect, 1-500. Each results page (25 jobs) is billed one
            unit.
        - name: details
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Add each job's page: full description by section, contract and
              work type, address with coordinates, company size. Up to 50 jobs;
              one more unit per job page fetched.
            default: false
            title: Details
          description: >-
            Add each job's page: full description by section, contract and work
            type, address with coordinates, company size. Up to 50 jobs; one
            more unit per job page fetched.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the requests are sent from (ISO-2, e.g. 'DE'). Leave
              blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the requests are sent from (ISO-2, e.g. 'DE'). Leave
            blank to let the API pick.
      responses:
        '200':
          description: JSON with a `jobs` array plus totals.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: StepStone found no jobs for this search.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by StepStone, no results page returned, or the call did not
            finish in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.