StepStone.at Scraper - Austrian Job Portal

Scrapes job listings from StepStone.at - Austria's leading job platform with 40,000+ jobs across all 9 Bundesländer.

Features

• Comprehensive Coverage: All 9 Austrian Bundesländer (Wien, Niederösterreich, Oberösterreich, Steiermark, Tirol, Kärnten, Salzburg, Vorarlberg, Burgenland)
• Advanced Filtering: Employment type, experience level, date posted, search radius
• Direct URL Mode: Scrape specific job URLs for status checking and updates
• Full Job Details: JSON-LD extraction for structured data
• LLM Enhancement: Optional AI extraction of requirements, benefits, and contact info
• Proxy Support: Residential proxy rotation for reliable scraping
• Standardized Output: Compatible with all Santamaria job scrapers

Input Parameters

Field	Type	Description	Default
directUrls	array	Direct StepStone.at job URLs to scrape (skips search)	-
searchQuery	string	Keywords, job title, or skills (Was)	-
location	string	City or region in Austria (Wo)	-
radius	integer	Search radius in kilometers (0-200)	30
bundesland	string	Austrian federal state	-
employmentType	string	Vollzeit, Teilzeit, Freelance, Ausbildung, Praktikum	All
experienceLevel	string	Einsteiger, Berufserfahren, Führungskraft	All
datePosted	string	Jobs posted within: 1, 7, or 30 days	All
maxResults	integer	Maximum job listings to scrape	10
includeJobDetails	boolean	Visit detail pages for full descriptions	true
llmApiKey	string	Groq/OpenRouter API key for AI extraction	-
llmModel	string	AI model: llama-3.1-8b-instant, mistral-small	none
proxyConfiguration	object	Apify proxy settings	Residential

Austrian Bundesländer

• Wien (W) - Vienna
• Niederösterreich (NÖ) - Lower Austria
• Oberösterreich (OÖ) - Upper Austria
• Steiermark (ST) - Styria
• Tirol (T) - Tyrol
• Kärnten (K) - Carinthia
• Salzburg (S) - Salzburg
• Vorarlberg (V) - Vorarlberg
• Burgenland (B) - Burgenland

Output Schema

Each job listing follows the standardized JobListing schema:

{
  "id": "software-engineer-wien-12345",
  "title": "Software Engineer",
  "company": "TechCorp Austria GmbH",
  "location": "Wien",
  "canton": "W",
  "salary_min": 50000,
  "salary_max": 70000,
  "salary_currency": "EUR",
  "salary_text": "EUR 50,000 - 70,000 per year",
  "employment_type": "full-time",
  "workload_min": 100,
  "workload_max": 100,
  "remote_option": "hybrid",
  "description_snippet": "Wir suchen einen erfahrenen Software Engineer...",
  "description_full": "Full job description text...",
  "requirements": [
    "5+ Jahre Erfahrung in der Softwareentwicklung",
    "Expertise in Java, Spring Boot",
    "Agile Methodologien"
  ],
  "posted_at": "2024-01-15T00:00:00Z",
  "expires_at": "2024-02-15T00:00:00Z",
  "source_url": "https://www.stepstone.at/job/...",
  "source_platform": "stepstone.at",
  "apply_url": "https://...",
  "apply_email": "jobs@techcorp.at",
  "contact_firstname": "Maria",
  "contact_lastname": "Müller",
  "contact_salutation": "Frau",
  "contact_email": "maria.mueller@techcorp.at",
  "contact_phone": "+43 1 234567890",
  "contact_position": "HR Manager",
  "company_url": "https://www.stepstone.at/cmp/at/TechCorp-Austria-12345/jobs.html",
  "company_website": "https://www.techcorp.at",
  "company_job_count": 8,
  "company_description": "Leading tech company in Austria...",
  "company_benefits": [
    "Flexible Arbeitszeiten",
    "Homeoffice-Möglichkeit",
    "Weiterbildungsmöglichkeiten"
  ],
  "scraped_at": "2024-01-16T12:00:00Z"
}

Usage Examples

Search for Software Jobs in Vienna

{
  "searchQuery": "Software Engineer",
  "location": "Wien",
  "radius": 30,
  "employmentType": "Vollzeit",
  "maxResults": 50,
  "includeJobDetails": true
}

Search by Bundesland

{
  "searchQuery": "Pflege",
  "bundesland": "Tirol",
  "employmentType": "Teilzeit",
  "maxResults": 100
}

Recent Jobs Only

{
  "searchQuery": "Data Analyst",
  "location": "Salzburg",
  "datePosted": "7",
  "maxResults": 20
}

Direct URL Mode (Status Checking)

{
  "directUrls": [
    "https://www.stepstone.at/job/software-engineer-abc123",
    "https://www.stepstone.at/job/data-scientist-xyz789"
  ],
  "includeJobDetails": true,
  "llmApiKey": "gsk_...",
  "llmModel": "llama-3.1-8b-instant"
}

With AI Enhancement

{
  "searchQuery": "Marketing Manager",
  "location": "Graz",
  "maxResults": 30,
  "includeJobDetails": true,
  "llmApiKey": "gsk_YOUR_GROQ_KEY",
  "llmModel": "llama-3.1-8b-instant"
}

API Usage

Via Apify API

curl -X POST "https://api.apify.com/v2/acts/santamaria~stepstone-at-scraper/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchQuery": "Pflege",
    "bundesland": "Wien",
    "employmentType": "Vollzeit",
    "maxResults": 50
  }'

Via Apify JavaScript SDK

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('santamaria/stepstone-at-scraper').call({
  searchQuery: 'Software Engineer',
  location: 'Wien',
  maxResults: 100,
  includeJobDetails: true,
});

const dataset = await client.dataset(run.defaultDatasetId).listItems();
console.log(dataset.items);

Output Modes

1. Search Mode (Default)

Searches StepStone.at with filters and scrapes job listings.

2. Direct URL Mode

Scrapes specific job URLs - useful for:

• Monitoring job status (online/offline/expired)
• Updating existing job data
• Verifying job details
• Tracking changes over time

AI Enhancement (Optional)

When you provide a Groq or OpenRouter API key, the scraper uses AI to extract:

• Requirements: Structured list of job requirements and qualifications
• Benefits: Company benefits and perks
• Contact Information: Name, email, phone, position of recruiter
• Salutation: Herr/Frau for proper addressing

Supported Models

1. llama-3.1-8b-instant (Groq) - Fast and accurate, best for most use cases
2. mistral-small-3.1-24b-instruct (OpenRouter) - Higher quality, slower

Get API keys:

• Groq: https://console.groq.com (starts with gsk_)
• OpenRouter: https://openrouter.ai

Performance

• Without detail pages: ~100 jobs in 30 seconds
• With detail pages: ~100 jobs in 2-3 minutes
• With AI extraction: ~100 jobs in 3-5 minutes

Pricing

Typical Apify compute unit (CU) consumption:

• 100 jobs (search only): ~0.01 CU
• 100 jobs (with details): ~0.02 CU
• 100 jobs (with AI): ~0.03-0.05 CU

Note: AI extraction requires separate API keys (Groq/OpenRouter) with their own pricing.

Common Use Cases

1. Healthcare Jobs Across Austria

{
  "searchQuery": "Pflege Krankenschwester",
  "maxResults": 500,
  "includeJobDetails": true,
  "llmApiKey": "gsk_...",
  "llmModel": "llama-3.1-8b-instant"
}

2. Tech Jobs in Vienna

{
  "searchQuery": "Software Developer",
  "location": "Wien",
  "radius": 20,
  "employmentType": "Vollzeit",
  "experienceLevel": "Berufserfahren",
  "maxResults": 200
}

3. Entry-Level Jobs

{
  "experienceLevel": "Einsteiger",
  "bundesland": "Salzburg",
  "datePosted": "7",
  "maxResults": 100
}

4. Remote/Freelance Opportunities

{
  "searchQuery": "Remote",
  "employmentType": "Freelance",
  "maxResults": 150
}

Technical Details

• Platform: StepStone.at (server-rendered HTML)
• Crawler: CheerioCrawler (HTTP-only, no browser needed)
• Data Extraction: JSON-LD structured data + HTML parsing
• Contact Extraction: Email, phone, and company website via regex; names via LLM only (to avoid false positives)
• Rate Limiting: Respectful scraping with configurable delays
• Proxy: Residential proxy rotation for reliability
• Error Handling: Graceful degradation and retry logic

Bundesland Codes

The canton field uses standard Austrian Bundesland codes:

Code	Bundesland	Major Cities
W	Wien	Vienna
NÖ	Niederösterreich	St. Pölten, Wiener Neustadt
OÖ	Oberösterreich	Linz, Wels, Steyr
ST	Steiermark	Graz
T	Tirol	Innsbruck
K	Kärnten	Klagenfurt, Villach
S	Salzburg	Salzburg
V	Vorarlberg	Dornbirn, Bregenz, Feldkirch
B	Burgenland	Eisenstadt

Support

For issues, feature requests, or questions:

• GitHub: santamaria-apify-scrapers
• Email: support@santamaria.com

---

Part of the Santamaria Job Scrapers Suite - Professional-grade job data for the DACH region and beyond.