YourFirm.de Job Scraper

Scrape job listings from YourFirm.de — one of Germany's leading job boards for the SME sector. Search by keyword and filter by location, contract type, working hours, and more.

What it does

• Searches YourFirm.de by any job title keyword (e.g. Tiefbauer, Elektriker, Maurer)
• Scrapes all result pages automatically with smart early-stop (stops if pages return no results)
• Applies filters: location, radius, working hours, contract model, home office, and posting date
• Outputs structured data ready for CSV export, webhooks, or CRM import

Output fields

Every job includes the search-card fields:

Field	Description
jobId	Unique job ID on YourFirm.de (e.g. REG28901958, YF-46946)
title	Full job title
company	Employer name
location	City or region (comma-separated when multi-location)
url	Direct link to the job listing
employmentType	Full-time / Part-time
benefits	List of perks (e.g. company car, job bike, 30+ vacation days)
postedDate	Date the listing went live (DD.MM.YYYY)
refNo	Employer's internal reference number
logoUrl	Company logo image URL
keyword	The search keyword used

With Fetch Full Job Details (fetchDetails) enabled, each job additionally includes:

Field	Description
description	Full job description (plain text)
descriptionHtml	Full job description (original HTML)
datePosted	Posting date (ISO)
validThrough	Listing expiry date (ISO)
employmentTypeDetail	Structured type, e.g. FULL_TIME
companyLogo	High-resolution logo URL
jobLocations	Structured locations: city, postal code, region, country, latitude/longitude — one entry per work location
applyUrl	Employer's application URL (when the listing has one)
applicationEmail	Application email address (when the listing has one)
applicationTargets	All application URLs/emails found in the listing

Example output

{
  "jobId": "REG28901958",
  "title": "Civil Engineering Specialist (m/f/d)",
  "company": "PPS Pipeline Systems GmbH",
  "location": "Leipzig, Landau in der Pfalz",
  "url": "https://www.yourfirm.de/job/pps-pipeline-systems-gmbh/tiefbaufacharbeiter-in-mwd/reg28901958/",
  "employmentType": "Full-time",
  "benefits": ["Childcare", "Job bike", "Employee savings plan"],
  "postedDate": "12.07.2026",
  "refNo": "REG-34966",
  "logoUrl": "https://anzeigen.jobstatic.de/upload/logos/8/467488.gif",
  "keyword": "Civil Engineer",
  "description": "For 70 years, PPS Pipeline Systems GmbH has stood for innovative projects in pipeline and plant construction. …",
  "descriptionHtml": "<p>…</p>",
  "datePosted": "2026-07-12",
  "validThrough": "2026-08-02",
  "employmentTypeDetail": "FULL_TIME",
  "companyLogo": "https://logos.jobstatic.de/g4j/logo/467488.png",
  "jobLocations": [
    { "city": "Leipzig", "postalCode": "04103", "region": "Saxony", "country": "DE", "latitude": 51.33828, "longitude": 12.37793 },
    { "city": "Landau in der Pfalz", "postalCode": "76829", "region": "Rheinland-Pfalz", "country": "DE", "latitude": 49.19759, "longitude": 8.11227 }
  ],
  "applicationTargets": [
    "https://jobs.pipelinesystems.de/Tiefbaufacharbeiterin-mwd-de-f215.html",
    "karriere@pipelinesystems.de"
  ],
  "applyUrl": "https://jobs.pipelinesystems.de/Tiefbaufacharbeiterin-mwd-de-f215.html",
  "applicationEmail": "karriere@pipelinesystems.de"
}

Input parameters

Parameter	Type	Description
fulltext	String	Required. Job title keyword to search for
maxPages	Integer	Max pages to scrape. 0 = all pages
maxEmptyPages	Integer	Stop after N consecutive empty pages (default: 2)
location	String	City, postal code, or region (e.g. Berlin, 10115)
perimeterRadius	Integer	Radius in km around location (e.g. 25)
employmentType	String	vollzeit = Full-time, teilzeit = Part-time
contractType	String	festanstellung, ausbildung, praktikum, freiberufler, etc.
homeOfficeType	String	100-homeoffice or hybrides-arbeiten
onlyAdsOnlineForDays	Integer	1 = yesterday, 7 = last week, 30 = last month, 0 = all time
fetchDetails	Boolean	Visit each job page for the full description, structured locations, and apply URL/email (see detail fields above)
proxyConfig	Object	Recommended: Apify Residential proxy with country=DE

Proxy requirement

YourFirm.de is a German job board and may restrict access from non-German IP addresses. For reliable results, use Apify Residential Proxies with apifyProxyCountry: "DE" — this is pre-configured in the default input.

Use cases

• Recruitment agencies — monitor new job postings in specific trades
• Lead generation — find companies hiring in your target industry
• Market research — track hiring trends across German SMEs
• Job aggregators — feed listings into your own platform