Kalaydo.de Jobs Scraper: Extract German Job Listings at Scale

---

What Is Kalaydo.de?

Kalaydo.de is a German online classifieds platform covering jobs, real estate, and vehicles, with a strong presence in regional German job markets. Its job section lists roles across apprenticeships, permanent positions, freelance contracts, and leadership roles. Manually collecting listings across regions is impractical — the Kalaydo.de Jobs Scraper automates extraction from search result pages, turning paginated listings into clean, structured datasets.

---

Overview

The Kalaydo Jobs Scraper processes Kalaydo.de job search result URLs and returns structured records for each listing. It is suited for:

• Recruiters monitoring regional German job markets
• HR analysts benchmarking salaries and contract types
• Job aggregators ingesting German-language listings
• Researchers studying regional employment trends in Germany

The scraper supports bulk URL input, configurable item limits, and fault-tolerant execution for large-scale runs.

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of Kalaydo.de job search result URLs.

{
  "urls": [
    "https://www.kalaydo.de/suchergebnisse/?locationIds=C-DE&contractType=Apprenticeship&contractType=Permanent&contractType=Freelancer&managementType=LeadingPosition&perimeterRadius=50&sort=Datum&jobId=16125173"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

2. Scrape by search filters — scrape data using a keyword and additional filters (location, radius, contract type, etc.) instead of providing URLs.

{
    "keyword": "design",
    "location": "C-DE",
    "radius": 75,
    "sort_by": "Datum",
    "employment_type": "FullTime",
    "published_at": 7,
    "contract_type": "Permanent",
    "offset": 25,
    "max_items_per_url": 100
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific search result URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	One or more Kalaydo.de job search result URLs to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. Build these directly from Kalaydo's search filters (location, contract type, radius, sort order, etc.). Add multiple URLs for multi-page or multi-query runs.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
location	string	—	The location to search for. Must be a valid locationIds value as used in the Kalaydo URL.
radius	string ("", 10–200)	—	Search radius in kilometers: Any, 10 km, 20 km, 30 km, 40 km, 50 km, 75 km, 100 km, 200 km.
sort_by	string ("", Datum, Entfernung)	—	Sort results by Relevance (empty), Date (Datum), or Distance (Entfernung).
employment_type	string ("", FullTime, PartTime)	—	Employment type: All, Full time, Part time.
published_at	string ("", 1, 7, 30)	—	Filter by publish date: All, Last 24 hours, Last week, Last month.
contract_type	string ("", Permanent, Temporary, Apprenticeship, Freelancer, Internship, WorkingStudent, MiniJob)	—	Filter by contract type: Any, Permanent position, Fixed-term contract, Training, Freelancers, Internship, Working student, Part-time job.
offset	integer	—	The offset to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	The maximum number of job listings to collect per URL/search. Increase to 50+ for broader datasets.

Building Your Search URL (for Scrape by URLs mode)

Navigate to kalaydo.de, apply your desired filters (location, contract type, management level, radius), then copy the resulting URL from your browser. The URL encodes all parameters, including:

• locationIds — region/location filter
• contractType — contract type (multiple values supported)
• managementType — management level
• perimeterRadius — search radius
• sort — result ordering (e.g., Datum for date)

Example use case: The prefilled URL searches nationwide (locationIds=C-DE) for apprenticeship, permanent, and freelance positions in leading/management roles, within a 50 km radius, sorted by date.

---

Output Format

Sample output

{
  "company_profile": {
    "industry": "Versicherungen ",
    "color": "#dcdcdc",
    "company_names": [
      "HanseMerkur",
      "HanseMerkur Versicherungsgruppe"
    ],
    "company_names_url_format": [
      "hansemerkur",
      "hansemerkur-versicherungsgruppe"
    ],
    "description": "",
    "employee_count": "k.A.",
    "profile_id": "2-1538",
    "id": "1538",
    "id_company": 0,
    "id_reseller": 0,
    "key_visual_link": "https://firmenprofil.stellenanzeigen.de/arbeitgeberprofil/media/1538/keyvisual-637678181635478293.jpg",
    "link": "https://firmenprofil.stellenanzeigen.de/arbeitgeberprofil/hansemerkur-versicherungsgruppe/standalone/",
    "locations": "Hamburg",
    "logo_link": "https://firmenprofil.stellenanzeigen.de/arbeitgeberprofil/media/1538/logo-637678225183952071.jpg",
    "type": "StefiPremium",
    "lastupdate": "2025-11-12T14:36:19.941+00:00",
    "jobs_count": 24,
    "slug": "hansemerkur-versicherungsgruppe",
    "is_group": false
  },
  "application_types": [
    {
      "application_target": "https://t.gohiring.com/h/d259eaa4cec8ddd8b7b0f6dce7c140379f7c54634716a6990748965a80b8d24b",
      "application_type": "AMS",
      "prio": 1
    }
  ],
  "backfill": true,
  "categories": [
    7
  ],
  "company_name": "HanseMerkur Versicherungsgruppe",
  "company_name_url_format": "hansemerkur-versicherungsgruppe",
  "departments": [
    {
      "department_id": 20,
      "prio": true
    }
  ],
  "email": "https://t.gohiring.com/h/d259eaa4cec8ddd8b7b0f6dce7c140379f7c54634716a6990748965a80b8d24b",
  "id": "16125172",
  "link": "https://www.kalaydo.de/jobs/16125172/Vertriebspartner_m_w_d_Regionalgeschaeftsstelle_M/",
  "link_internal": "https://anzeigen.jobstatic.de/docs/sa/pimcore_gohiring/SDE-83856/index.html",
  "location_ids": [
    "S-DEA"
  ],
  "logo_url": "https://anzeigen.jobstatic.de/upload/logos/5/441165.gif",
  "mobile_version": "Standard",
  "original_start_date": "2026-02-20T11:42:18+00:00",
  "portal": "stanz",
  "portal_link": "https://www.stellenanzeigen.de/job/vertriebspartner-m-w-d-regionalgeschaeftsstelle-muenster-gronau-duelmen-16125172/",
  "position_title": "Vertriebspartner (m/w/d) Regionalgeschäftsstelle",
  "product_type": "InternalBackfill",
  "reference_number": "a3581cc6-83c8-4d98-ae98-5926bd711b55",
  "region": "Münster, Gronau, Dülmen",
  "region_alternative": "Münster, Gronau, Dülmen",
  "regions": [
    {
      "id_location": "S-DEA",
      "latitude": 0,
      "longitude": 0,
      "region": "Nordrhein-Westfalen",
      "country": "Deutschland"
    }
  ],
  "start_date": "2026-05-21T05:00:20+00:00",
  "subcategories": [
    146,
    42
  ],
  "subproperties": [
    9,
    14,
    15,
    16,
    22,
    24,
    33,
    34
  ],
  "subdepartments": [
    {
      "subdepartment_id": 191,
      "prio": true
    }
  ],
  "text_mining_benefit_ids": [],
  "salary_max": 0,
  "salary_min": 0
}

Each listing returns up to 30 fields:

Identification & Links

Field	Meaning
ID	Unique internal Kalaydo identifier for the listing
Link	Full public URL to the job detail page
Link Internal	Internal platform reference link
Portal	Name of the portal/source hosting the listing
Portal Link	URL of the originating portal
Reference Number	Employer's internal reference code for the role
Mobile Version	Mobile-optimized URL or flag for the listing

Job Details

Field	Meaning
Position Title	Job title as displayed on the listing
Departments	Primary department (e.g., IT, Sales, Engineering)
Subdepartments	More granular department classification
Categories	Broad occupational categories
Subcategories	Narrower role classifications within a category
Product Type	Listing product tier (e.g., standard, premium)
Backfill	Indicates whether the listing is a backfill/programmatic placement
Application Types	Available application methods (e.g., email, online form)
Email	Contact email address for applications, if provided
Text Mining Benefit IDs	Extracted benefit identifiers from listing text (e.g., remote work, company car)

Salary

Field	Meaning
Salary Min	Minimum salary advertised for the role
Salary Max	Maximum salary advertised for the role

Note: Salary fields are only populated when explicitly stated in the listing.

Location & Region

Field	Meaning
Region	Primary region name for the listing
Region Alternative	Alternative or secondary region label
Regions	Full list of associated regions
Location IDs	Kalaydo location identifier codes (e.g., C-DE for all Germany)

Company

Field	Meaning
Company Name	Employer name as shown on the listing
Company Name URL Format	Slugified/URL-safe version of the company name
Company Profile	Link or metadata pointing to the company's Kalaydo profile
Logo URL	URL of the company's logo image

Dates

Field	Meaning
Start Date	Date the listing became active on the platform
Original Start Date	Original publication date if the listing was refreshed
Subproperties	Additional structured metadata returned by the platform API

---

How to Use

1. Build your search URL — Use Kalaydo.de's search interface to filter by location, contract type, radius, and sort order. Copy the resulting URL from your browser.
2. Configure input — Paste one or more search URLs into the urls array. Adjust max_items_per_url based on how many results you need.
3. Set fault tolerance — Keep ignore_url_failures: true for multi-URL runs to prevent a single failure from stopping the job.
4. Run and export — Start the scraper and download results as JSON, CSV, or Excel.

Common issues:

• URLs must be Kalaydo search result pages (containing /suchergebnisse/), not individual job detail pages.
• If results seem incomplete, check that your search URL returns visible listings when opened in a browser.

---

Use Cases & Business Value

• Regional talent mapping: Understand hiring activity across specific German cities or federal states
• Salary benchmarking: Use Salary Min/Salary Max fields to analyze compensation ranges by role or region
• Job board aggregation: Feed structured German-language listings into custom platforms
• Market research: Track volume and types of listings (apprenticeships vs. permanent) over time

---

Conclusion

The Kalaydo.de Jobs Scraper provides reliable, structured access to one of Germany's regional job markets. With 30+ output fields covering job details, salary ranges, company data, and location metadata, it eliminates manual data collection and integrates cleanly into any HR tech or research workflow. Configure your search URL, set your limits, and run.