AMS.at Job Scraper - Austrian Employment Service

English | Deutsch

---

English

Overview

This Apify actor scrapes job listings from the Austrian Public Employment Service (Arbeitsmarktservice Österreich - AMS.at). It retrieves job postings from the official AMS JobRoom platform at jobroom.ams.at.

The scraper supports filtering by:

• Keywords/profession (Beruf)
• Location/city (Arbeitsort)
• Austrian federal states (Bundesländer)
• Employment type (Vollzeit, Teilzeit, Geringfügig)

Features

• Search Mode: Search for jobs using keywords, location, and filters
• Direct URL Mode: Check status of specific job listings by URL
• Full Job Details: Optional detailed scraping including contact information
• Rate Limiting: Respectful scraping with configurable delays
• Proxy Support: Built-in Apify proxy integration
• Data Validation: Comprehensive schema validation using Zod
• Deduplication: Automatic removal of duplicate job listings

Input Parameters

{
  "searchQuery": "Software Developer",
  "location": "Wien",
  "bundesland": "Wien",
  "employmentType": "Vollzeit",
  "maxResults": 10,
  "includeJobDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Parameters

Parameter	Type	Required	Default	Description
searchQuery	string	No	""	Job title, profession, or keywords (e.g., "Kellner", "Mechaniker")
location	string	No	""	City or region name (e.g., "Wien", "Salzburg")
bundesland	string	No	""	Austrian federal state (Wien, Niederösterreich, Oberösterreich, etc.)
employmentType	string	No	""	Employment type: "Vollzeit", "Teilzeit", or "Geringfügig"
maxResults	integer	No	10	Maximum number of jobs to scrape (1-1000)
includeJobDetails	boolean	No	true	Fetch complete job descriptions and contact info
proxyConfiguration	object	No	Apify proxy	Proxy configuration for bypassing rate limits

Austrian Federal States (Bundesländer)

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

Output Schema

Each job listing includes:

{
  id: string;                    // Unique job ID
  title: string;                 // Job title
  company: string | null;        // Company name
  location: string;              // Location string
  canton: string | null;         // Austrian state code (W, NÖ, OÖ, etc.)

  // Salary
  salary_min: number | null;
  salary_max: number | null;
  salary_currency: string;       // "EUR"
  salary_period: string | null;

  // Employment
  employment_type: string | null; // "full-time", "part-time", "temporary"
  workload_min: number | null;    // Percentage (0-100)
  workload_max: number | null;    // Percentage (0-100)
  remote_option: string | null;   // "remote", "hybrid", "onsite"

  // Content
  description_snippet: string | null;
  description_full: string | null;
  requirements: string[];

  // Dates
  posted_at: string | null;      // ISO 8601
  expires_at: string | null;     // ISO 8601

  // URLs
  source_url: string;            // Job detail page URL
  source_platform: "ams.at";

  // Contact
  contact_salutation: string | null; // "Herr", "Frau"
  contact_firstname: string | null;
  contact_lastname: string | null;
  contact_email: string | null;
  contact_phone: string | null;

  // Application
  apply_url: string | null;
  apply_email: string | null;

  // Company
  company_url: string | null;

  // Status (only in direct URL mode)
  job_status: "online" | "offline" | "expired" | "unknown" | null;

  scraped_at: string;            // ISO 8601
}

Usage Examples

Example 1: Search for Software Jobs in Vienna

{
  "searchQuery": "Software Engineer",
  "location": "Wien",
  "bundesland": "Wien",
  "maxResults": 50
}

Example 2: Part-time Jobs in Salzburg

{
  "searchQuery": "Teilzeit",
  "bundesland": "Salzburg",
  "employmentType": "Teilzeit",
  "maxResults": 20
}

Example 3: Check Specific Job URLs

{
  "directUrls": [
    "https://jobroom.ams.at/jobsuche/Jobdetails.aspx?pc=XXXXXXX",
    "https://jobroom.ams.at/jobsuche/Jobdetails.aspx?pc=YYYYYYY"
  ]
}

API Information

This scraper uses the AMS JobRoom API for efficient data retrieval:

• Base URL: https://jobroom.ams.at/api/jobs/_search
• Method: POST (search), GET (job details)
• Rate Limiting: 3 seconds between requests

Performance

• Speed: ~10-30 jobs per minute (with rate limiting)
• Memory: 512 MB - 4 GB recommended
• Proxy: Residential proxy recommended for larger scrapes

Support

For issues or questions:

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

---

Deutsch

Überblick

Dieser Apify-Actor sammelt Stellenanzeigen vom Arbeitsmarktservice Österreich (AMS.at). Er ruft Stellenangebote von der offiziellen AMS JobRoom-Plattform unter jobroom.ams.at ab.

Der Scraper unterstützt Filterung nach:

• Stichworten/Beruf
• Ort/Stadt (Arbeitsort)
• Österreichische Bundesländer
• Beschäftigungsart (Vollzeit, Teilzeit, Geringfügig)

Funktionen

• Suchmodus: Suche nach Jobs mit Stichwörtern, Ort und Filtern
• Direkt-URL-Modus: Überprüfung des Status bestimmter Stellenanzeigen per URL
• Vollständige Jobdetails: Optional detailliertes Scraping inkl. Kontaktinformationen
• Rate Limiting: Respektvolles Scraping mit konfigurierbaren Verzögerungen
• Proxy-Unterstützung: Integrierte Apify-Proxy-Integration
• Datenvalidierung: Umfassende Schema-Validierung mit Zod
• Deduplizierung: Automatische Entfernung doppelter Stellenanzeigen

Eingabeparameter

{
  "searchQuery": "Softwareentwickler",
  "location": "Wien",
  "bundesland": "Wien",
  "employmentType": "Vollzeit",
  "maxResults": 10,
  "includeJobDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
searchQuery	string	Nein	""	Berufsbezeichnung, Beruf oder Stichwörter (z.B. "Kellner", "Mechaniker")
location	string	Nein	""	Stadt oder Regionsname (z.B. "Wien", "Salzburg")
bundesland	string	Nein	""	Österreichisches Bundesland (Wien, Niederösterreich, Oberösterreich, etc.)
employmentType	string	Nein	""	Beschäftigungsart: "Vollzeit", "Teilzeit" oder "Geringfügig"
maxResults	integer	Nein	10	Maximale Anzahl zu scrapender Jobs (1-1000)
includeJobDetails	boolean	Nein	true	Vollständige Jobbeschreibungen und Kontaktinformationen abrufen
proxyConfiguration	object	Nein	Apify-Proxy	Proxy-Konfiguration zur Umgehung von Rate Limits

Ausgabeschema

Jede Stellenanzeige enthält:

{
  id: string;                    // Eindeutige Job-ID
  title: string;                 // Jobtitel
  company: string | null;        // Firmenname
  location: string;              // Standort-String
  canton: string | null;         // Bundesland-Code (W, NÖ, OÖ, etc.)

  // Gehalt
  salary_min: number | null;
  salary_max: number | null;
  salary_currency: string;       // "EUR"
  salary_period: string | null;

  // Beschäftigung
  employment_type: string | null; // "full-time", "part-time", "temporary"
  workload_min: number | null;    // Prozent (0-100)
  workload_max: number | null;    // Prozent (0-100)
  remote_option: string | null;   // "remote", "hybrid", "onsite"

  // Inhalt
  description_snippet: string | null;
  description_full: string | null;
  requirements: string[];

  // Datum
  posted_at: string | null;      // ISO 8601
  expires_at: string | null;     // ISO 8601

  // URLs
  source_url: string;            // Job-Detail-Seiten-URL
  source_platform: "ams.at";

  // Kontakt
  contact_salutation: string | null; // "Herr", "Frau"
  contact_firstname: string | null;
  contact_lastname: string | null;
  contact_email: string | null;
  contact_phone: string | null;

  // Bewerbung
  apply_url: string | null;
  apply_email: string | null;

  // Firma
  company_url: string | null;

  // Status (nur im Direkt-URL-Modus)
  job_status: "online" | "offline" | "expired" | "unknown" | null;

  scraped_at: string;            // ISO 8601
}

Verwendungsbeispiele

Beispiel 1: Suche nach Software-Jobs in Wien

{
  "searchQuery": "Softwareentwickler",
  "location": "Wien",
  "bundesland": "Wien",
  "maxResults": 50
}

Beispiel 2: Teilzeitjobs in Salzburg

{
  "searchQuery": "Teilzeit",
  "bundesland": "Salzburg",
  "employmentType": "Teilzeit",
  "maxResults": 20
}

Beispiel 3: Überprüfung spezifischer Job-URLs

{
  "directUrls": [
    "https://jobroom.ams.at/jobsuche/Jobdetails.aspx?pc=XXXXXXX",
    "https://jobroom.ams.at/jobsuche/Jobdetails.aspx?pc=YYYYYYY"
  ]
}

API-Informationen

Dieser Scraper verwendet die AMS JobRoom API für effizientes Datenabrufen:

• Basis-URL: https://jobroom.ams.at/api/jobs/_search
• Methode: POST (Suche), GET (Job-Details)
• Rate Limiting: 3 Sekunden zwischen Anfragen

Leistung

• Geschwindigkeit: ~10-30 Jobs pro Minute (mit Rate Limiting)
• Speicher: 512 MB - 4 GB empfohlen
• Proxy: Residential Proxy empfohlen für größere Scrapes

Unterstützung

Für Probleme oder Fragen:

• GitHub: santamaria-apify-scrapers
• E-Mail: support@santamaria.com

---

License

MIT License - Copyright (c) 2024 Santamaria

Version History

• 1.0.0 (2024-12-22): Initial release
  • Search mode with keyword, location, and state filters
  • Direct URL mode for status checking
  • Full job details scraping
  • Austrian federal state support
  • Employment type filtering