---
title: "Search Stepstone Jobs"
method: GET
path: "/stepstone/jobs"
tags: ["Stepstone"]
---

# Search Stepstone Jobs

`GET /stepstone/jobs`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/stepstone/jobs`
- Auth: API key in header `X-API-KEY`

Search for job listings on Stepstone with various filters.

## Query parameters

- `query` string, required
- `location` string, nullable
- `country` 'de' | 'at' | 'nl' | 'be' | 'null', nullable
- `radius` integer, nullable
- `sort` 'relevance' | 'date' | 'null', nullable
- `job_type` 'full_time' | 'part_time' | 'null', nullable
- `work_from_home` boolean, nullable
- `date_posted` integer, nullable
- `page` integer, nullable
- `limit` integer, nullable

## Response `200`

- object
  - `success` boolean, required
  - `data` object, required
    - `jobs` object[], required
      - `id` string, required
      - `title` string, nullable, required
      - `url` string, nullable, required
      - `company` object, required
        - `id` integer, nullable, required
        - `name` string, nullable, required
        - `logo_url` string, nullable, required
        - `url` string, nullable, required
      - `location` object, required
        - `formatted` string, nullable, required
        - `city` string, nullable, required
        - `region` string, nullable, required
        - `country` string, nullable, required
      - `salary` object, nullable, required
        - `formatted` string, nullable, required
        - `min` number, nullable, required
        - `max` number, nullable, required
        - `currency` string, nullable, required
        - `period` string, nullable, required
      - `date_posted` string, nullable, required
      - `description` string, nullable, required
      - `contact_person` object, nullable, required
        - `name` string, nullable, required
        - `title` string, nullable, required
        - `email` string, nullable, required
        - `phone` string, nullable, required
      - `skills` string[], required
      - `labels` string[], required
      - `work_from_home` boolean, required
      - `is_highlighted` boolean, required
      - `is_sponsored` boolean, required
    - `pagination` object, required
      - `current_page` integer, required
      - `total_pages` integer, required
      - `total_jobs` integer, required
      - `has_more` boolean, required
      - `next_page` integer, nullable, required
    - `metadata` object, required
      - `query` string, required
      - `location` string, nullable, required
      - `country` string, required
      - `timestamp` string, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)