Komm zur Fonds Finanz …
", "descriptionMarkdown": "#### Software Engineer (Go) (m/w/d)\n\nKomm zur Fonds Finanz …" } ``` The `description`, `descriptionHtml` and `descriptionMarkdown` fields hold the complete job posting — trimmed above for readability. ### 📥 Example input A few ready-to-run configurations — set these in the visual editor or pass them as JSON via the API: ```json { "query": "data analyst", "location": "Berlin", "country": "de", "maxResults": 100 } ``` ```json { "query": "software engineer", "location": "Berlin", "contractType": "permanent", "workType": "full_time", "datePosted": "7", "jobLanguage": "en" } ``` ```json { "query": "product manager", "country": "at", "incrementalMode": true, "skipReposts": true, "notifyOnlyChanges": true, "telegramChatId": "@my_jobs_channel" } ``` *** ### 📚 What data can you extract? - **Core** — `id`, `title`, `url`, `companyName`, `companyId`, `companyLogoUrl`, `companyUrl`, `location`, `datePosted`, `textSnippet`, `source`, `searchKeyword`, `scrapedAt`, plus `salary` / `salaryMin` / `salaryMax` / `salaryCurrency` / `salaryPeriod` (populated on the minority of listings where StepStone publishes pay). - **Location & geo** — `postCode`, `country`, `region`, `streetAddress`, `latitude`, `longitude`, `travelTime`. - **Job details** (with **Fetch full details**) — `description`, `descriptionHtml`, `descriptionMarkdown`, `employmentType`, `industry`, `validThrough`, `workFromHome`, `remoteType`, `directApply`, `skills`, `labels`, `topLabels`, and flags (`isAnonymous`, `isHighlighted`, `isSponsored`, `isTopJob`). - **Change tracking** (with **Incremental mode**) — `changeType` (NEW / UPDATED / UNCHANGED / EXPIRED), `isRepost`, `repostOfId`, `repostDetectedAt`, `contentHash`. Every field is present in standard mode (missing values are `null`); **compact mode** returns the core fields only, for lean AI/MCP payloads. *** ### ⚙️ Input Configure it in the visual editor — no code needed — or pass JSON via the API. | Field | What it does | |---|---| | `query` | Keyword search — job title, skill or company (comma-separate for multiple searches). | | `location` | City or region, e.g. `Berlin` or `München`. | | `country` | StepStone edition: `de` (Germany) or `at` (Austria). | | `startUrls` | Scrape specific StepStone search or job URLs (any browser-applied filter is kept). | | `contractType` | Employment type: permanent, fixed-term, working-student, trainee, apprenticeship, internship, freelance, and more. | | `workType` | Full-time or part-time. | | `experience` | Experience level: none (entry-level), with experience, or management. | | `datePosted` | Only jobs posted in the last 1 / 3 / 7 / 14 days. | | `industry` | Industry sector (IT, construction, health, finance, and more). | | `bundesland` | German federal state (Germany edition); overrides Location. | | `jobLanguage` | Language the ad is written in (German or English). | | `applicationMethod` | Quick apply (on StepStone) or external (company website). | | `workFromHome` | Return only home-office / remote jobs. | | `onlyQuickApply` | Shortcut for `applicationMethod` = quick apply. | | `excludeSponsored` | Skip promoted / sponsored listings. | | `radius` | Widen the search around the location, in km. | | `sortBy` | `relevance` or `date` (newest first). | | `includeDetails` | Fetch each job's page for the full description and detail fields. | | `descriptionFormat` | `text`, `html`, `markdown` or all three. | | `descriptionMaxLength` | Truncate each description to N characters — keeps AI-agent payloads small. | | `incrementalMode` | Emit only what changed since the last run. | | `maxResults` | Cap the number of records (0 = unlimited). | | `maxPages` | Optional hard cap on result pages per search (25 jobs/page). | …and **40+ inputs** in total — the table shows the essentials; the rest cover compact/drop-empty output modes, incremental state, unchanged/expired and repost-skipping toggles, notification channels (Telegram, Slack, Discord, WhatsApp, webhook) with a notify-only-on-changes switch, and advanced tuning, all in the visual editor. *** ### 💡 Use cases - **Job-board monitoring** — schedule a saved search and get a live feed of only the new and changed vacancies, straight to your chat. - **Recruitment & sourcing** — pull structured company, location and role data across Germany and Austria, filtered by contract type, experience or industry. - **Market & hiring research** — aggregate employment types, industries, locations and posting volumes to benchmark demand for a role or region. - **Aggregators & job boards** — feed clean, de-duplicated StepStone listings into your own site, app or warehouse. - **Geo & mapping** — every job carries latitude/longitude, post code and street address for map views and radius analysis. - **AI agents & pipelines** — compact output plugs straight into LLM/MCP workflows. *** ### ♻️ Incremental monitoring — pay for changes, not repeats Schedule the actor and turn on **incremental mode**: each run compares against the last and tags every job **NEW / UPDATED / UNCHANGED / EXPIRED** — unchanged jobs are skipped *before* their detail page is fetched, so a daily watch costs a fraction of a full re-scrape. It even detects reposts of the same vacancy, which you can suppress with **skip reposts**. Pair it with a notification channel and **notify-only-on-changes**, and only the new and updated jobs land in your inbox. | Daily churn | of 1,000 tracked | billable records | you save | |---|---|---|---| | 5 % | 1,000 | 50 | **95 %** | | 15 % | 1,000 | 150 | **85 %** | | 30 % | 1,000 | 300 | **70 %** | The first run seeds the baseline and bills in full; every run after that bills only the delta — a genuinely low-cost way to keep a saved search fresh on a schedule. *** ### 🚀 How to run it 1. Open the actor, enter a **search keyword** (e.g. `data analyst`) and a **location**, and pick the **country edition** — or paste a StepStone URL. 2. (Optional) Narrow with filters — **contract type**, **working hours**, **experience**, **industry**, **federal state**, **date posted**, **home-office**, **radius** or **sort** — then set **Max results** and whether to **fetch full details**. 3. (Optional) Turn on **incremental mode** and a **notification** channel, then **Schedule** it. 4. Click **Start**. 5. Download the data as **JSON, CSV or Excel**, or pull it from the **API**. New to Apify? Create a free account — it comes with monthly credit, no credit card required. *** ### 🔌 Integrations & export Export to **JSON, CSV, Excel** or an HTML table, or pull from the **REST API** and the **JavaScript / Python** clients. Runs on a **schedule**, sends alerts to **Telegram, Slack, Discord, WhatsApp** or any **webhook** (Make, Zapier, n8n), connects to **Google Sheets**, and works as an **MCP tool** for AI agents — compact mode and description truncation keep token usage small. *** ### ❓ FAQ **Do I need a proxy or login?** No login and no setup — it runs out of the box with sensible defaults; you can adjust proxy settings under Advanced for very high-volume runs. **Which countries are supported?** StepStone Germany (`stepstone.de`) and Austria (`stepstone.at`), chosen from a dropdown. **Can I get only new items on a schedule?** Yes — turn on incremental mode and schedule it; each run emits only what changed and can notify Telegram, Slack, Discord, WhatsApp or a webhook, with a notify-only-on-changes option. **Can I get the full job description?** Yes — enable **Fetch full details** to get the complete description in plain text, HTML and Markdown, plus employment type, industry, geo-coordinates and validity date. You can also truncate it to a set length for smaller payloads. **Does it include salary?** The salary fields (`salaryMin` / `salaryMax` / `salaryCurrency` / `salaryPeriod`) are always in the schema and are filled whenever StepStone publishes pay — but most German and Austrian listings don't disclose it, so expect these to be empty on the majority of jobs. This actor reports only real, StepStone-provided figures; it does not invent salary estimates. **What formats can I export?** JSON, CSV, Excel, HTML table, or via the API. **Is it good for AI agents?** Yes — enable compact mode and cap the description length; the output is MCP-friendly and small. **How many records can I get?** As many as the search returns — set `maxResults` (0 = unlimited). **Is scraping this legal?** The actor collects only **publicly available** data. You are responsible for how you use it, including any personal data and GDPR-style obligations. *** ### ⚖️ Disclaimer This actor accesses only publicly available data on StepStone. You are responsible for how you use the extracted data — in particular any personal information — and for complying with the site's terms and applicable law (including the GDPR where it applies). Not affiliated with, endorsed by, or sponsored by StepStone. *** **Keywords:** StepStone scraper · StepStone job scraper · stepstone.de scraper · stepstone.at scraper · StepStone API · Germany job scraper · Austria job scraper · DACH job market data · job listings scraper · jobs by contract type · job monitoring · job alerts · home office jobs · remote jobs scraper · recruitment data · job market research · export jobs to CSV Excel JSON · no-code job scraper · MCP tool for AI agents · schedule job scraping # Actor input Schema ## `query` (type: `string`): Job title, skill, or company to search for (e.g. "data analyst"). Separate multiple searches with commas — each runs on its own and results are merged and de-duplicated. ## `location` (type: `string`): City or region to search in, e.g. "Berlin" or "München". Leave empty to search the whole country. ## `country` (type: `string`): Which StepStone site to search. ## `startUrls` (type: `array`): Paste StepStone search-result URLs (with any filters already applied in your browser) or individual job URLs. Both are scraped directly. ## `maxResults` (type: `integer`): Maximum number of records to return. Set 0 for unlimited (bounded by how many the search has). ## `maxPages` (type: `integer`): Optional hard cap on how many result pages to fetch per search (25 jobs per page). Leave empty to page until Max results is reached. ## `ignoreUrlFailures` (type: `boolean`): Skip URLs that cannot be interpreted instead of failing the whole run. ## `workFromHome` (type: `boolean`): Return only jobs that offer remote / home-office work. ## `contractType` (type: `string`): Filter by employment / contract type. ## `workType` (type: `string`): Filter by full-time or part-time. ## `experience` (type: `string`): Filter by required experience level. ## `datePosted` (type: `string`): Only return jobs posted within this many days. ## `industry` (type: `string`): Filter by industry sector. ## `bundesland` (type: `string`): Filter by German federal state (Bundesland). Overrides Location. Germany edition only. ## `jobLanguage` (type: `string`): Only return job ads written in this language. ## `applicationMethod` (type: `string`): Filter by how you apply. Quick apply = apply directly on StepStone; external = apply on the company's own site. ## `onlyQuickApply` (type: `boolean`): Shortcut for Application method = Quick apply. Return only jobs you can apply to directly on StepStone. ## `excludeSponsored` (type: `boolean`): Skip promoted / sponsored jobs (where isSponsored is true). ## `radius` (type: `integer`): Widen the search around the chosen location, in kilometres. Only applies when a location is set. ## `sortBy` (type: `string`): Order of the results. ## `includeDetails` (type: `boolean`): Fetch each item's detail page for the richer fields. Turn off for the fastest, cheapest runs. ## `descriptionFormat` (type: `string`): Which representation(s) of the job description to include. ## `descriptionMaxLength` (type: `integer`): Truncate each description to at most this many characters. Leave empty (or 0) for the full text — handy for keeping AI-agent payloads small. ## `compact` (type: `boolean`): Emit only the core fields. Ideal for AI agents and MCP clients. ## `excludeEmptyFields` (type: `boolean`): Remove null, empty-string and empty-array fields from each record. ## `incrementalMode` (type: `boolean`): Track state between runs and tag every record with a changeType (NEW / UPDATED / UNCHANGED / EXPIRED). ## `stateKey` (type: `string`): Stable name for the tracked search. Leave empty to derive one automatically from your search settings. ## `emitUnchanged` (type: `boolean`): Also emit records that have not changed since the previous run. ## `emitExpired` (type: `boolean`): Emit records for jobs present last run but gone now. ## `skipReposts` (type: `boolean`): In incremental mode, suppress jobs detected as reposts of a previously seen listing (same title + company reappearing under a new id). ## `telegramToken` (type: `string`): Bot token from @BotFather. ## `telegramChatId` (type: `string`): Chat or channel ID, e.g. "-100123456789" or "@yourchannel". ## `slackWebhookUrl` (type: `string`): Slack incoming-webhook URL. ## `discordWebhookUrl` (type: `string`): Discord incoming-webhook URL. ## `webhookUrl` (type: `string`): Any HTTPS endpoint. Receives a JSON POST with the matched records — works with n8n, Make and Zapier. ## `webhookHeaders` (type: `object`): Extra headers for the webhook request, e.g. {"Authorization": "Bearer xyz"}. ## `whatsappPhoneNumberId` (type: `string`): WhatsApp Cloud API phone-number ID (from Meta). Required with the access token and recipient below to send WhatsApp alerts. ## `whatsappAccessToken` (type: `string`): WhatsApp Cloud API access token. ## `whatsappTo` (type: `string`): Recipient phone number in international format, e.g. "491701234567". ## `notificationLimit` (type: `integer`): How many records to include in each notification message. ## `notifyOnlyChanges` (type: `boolean`): In incremental mode, only send notifications for NEW / UPDATED / REAPPEARED jobs (skip alerts when nothing relevant changed). ## `proxyConfiguration` (type: `object`): Residential proxies by default — required for full job descriptions and reliable access. Advanced users can switch groups, but residential is recommended for this site. ## `maxRequestRetries` (type: `integer`): How many times to retry a failed request before giving up on it. ## Actor input object example ```json { "query": "data analyst", "country": "de", "maxResults": 25, "ignoreUrlFailures": true, "workFromHome": false, "contractType": "", "workType": "", "experience": "", "datePosted": "", "industry": "", "bundesland": "", "jobLanguage": "", "applicationMethod": "", "onlyQuickApply": false, "excludeSponsored": false, "sortBy": "relevance", "includeDetails": true, "descriptionFormat": "all", "compact": false, "excludeEmptyFields": false, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "skipReposts": false, "notificationLimit": 5, "notifyOnlyChanges": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxRequestRetries": 3 } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `allItems` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '