NiceJob.de Scraper - German Regional Job Board avatar

NiceJob.de Scraper - German Regional Job Board

Pricing

from $3.00 / 1,000 results

Go to Apify Store
NiceJob.de Scraper - German Regional Job Board

NiceJob.de Scraper - German Regional Job Board

Scrapes job listings from NiceJob.de, a German regional job portal. Filter by location, workload percentage, and company type. Exclude recruitment agencies. Includes optional LLM-powered contact extraction.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

NanoScrape

NanoScrape

Maintained by Community

Actor stats

0

Bookmarked

9

Total users

1

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

Nicejob.de Job Scraper

Scrapes job listings from nicejob.de, a job portal for Germany. The board also lists jobs in Switzerland, Liechtenstein and Austria, and country reflects the job's real country.

Three Scraping Modes

This actor supports three distinct scraping modes for different use cases:

1. SEARCH MODE (Default)

Search for jobs by keyword and location (see location below). Returns job listings matching your search criteria. Supports multiple search keywords with deduplication.

Use case: Regular job scraping, finding new opportunities

Example input:

{
"searchQueries": ["Informatiker", "Softwareentwickler"],
"location": "St. Gallen",
"maxResultsPerQuery": 100
}

2. DIRECT URL MODE

Check if specific job URLs are still online (still alive checks). Fetches jobs by their URLs directly from the API.

Use case: Monitoring if previously scraped jobs are still available, updating job status in your database

Example input:

{
"directUrls": [
"https://www.nicejob.de/job/software-entwickler/12345",
"https://www.nicejob.de/job/projekt-manager/67890",
"https://www.nicejob.de/job/verkaufsberater/54321"
]
}

Output: Each job will have a job_status field:

  • "online" - Job is still available, full data extracted
  • "offline" - Job not found (404) or removed

3. SEARCH+DETAILS MODE

Search for jobs AND fetch full details. Same as SEARCH MODE but with includeJobDetails: true.

Use case: Get comprehensive job data including full descriptions

Example input:

{
"searchQueries": ["Pflege"],
"location": "Thurgau",
"maxResultsPerQuery": 100,
"includeJobDetails": true
}

Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client — Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

Apify MCP server URL:

https://mcp.apify.com?tools=santamaria-automations/nicejob-de-scraper

Example prompt once connected:

"Use nicejob-de-scraper to scrape job listings from nicejob de. Return results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) will receive the full input schema automatically via add-actor.

Features

  • API-based scraping - Uses the official Ostjob API for fast, reliable data extraction
  • Multi-query support - Run multiple search keywords in one actor run with automatic deduplication
  • Location input - Canton and district names (for example "Thurgau", "St. Gallen", "Frauenfeld") filter the search. Other city names may not resolve. In that case the run says so in its status message and returns jobs from all locations.
  • Sort by date - Get newest jobs first for job monitoring use cases
  • Workload filter - Filter by Pensum percentage (e.g., 40-60% for part-time)
  • Regional focus - Specializes in jobs from St. Gallen, Thurgau, Appenzell, Graubunden, and surrounding areas
  • Comprehensive job data - Extracts title, company, location, workload, contact details, and more
  • Company enrichment - Includes company description, social media URLs, and benefits when available
  • HR company filtering - Filter out recruitment agencies to get direct employer postings, or filter to only show HR agencies
  • Still alive checks - Verify if specific job URLs are still active
  • Standardized output - Returns data in the JobListing schema format
  • Rate-limited - Respectful 4-second delays between API requests
  • Built-in proxy handling - Nothing to configure

Input

FieldTypeDescriptionDefault
directUrlsarrayList of job URLs to scrape directly (for still alive checks)[]
searchQueriesstring[]One or more search keywords. Each runs as a separate search, deduplicated.["Informatiker"]
searchQuerystringSingle search keyword (legacy, backward compatible). Use searchQueries instead.""
locationstringCanton, district, or city name (e.g., "St. Gallen", "Thurgau"). Canton and district names (for example "Thurgau", "St. Gallen", "Frauenfeld") filter the search. Other city names may not resolve. In that case the run says so in its status message and returns jobs from all locations."" (all locations)
sortBystringnewest (date order) or relevance (best match). Maps to platform's by_date / by_relevance.newest
maxResultsPerQueryintegerMaximum results per search keyword (deduplicated)100
maxResultsintegerTotal cap across all queries. 0 = unlimited (each query limited by maxResultsPerQuery).0
workloadMinintegerMinimum workload/Pensum percentage (0-100)-
workloadMaxintegerMaximum workload/Pensum percentage (0-100)-
includeJobDetailsbooleanFetch full job descriptionstrue
companyFilterstringFilter by company type: all, exclude-hr, only-hrall
postedWithinDaysintegerOnly jobs first published within the last N days. Older jobs are dropped before saving and billing; jobs without a date are kept. With sortBy newest the search stops once a whole page is older.- (off)
titleFilterstringComma-separated title terms (case-insensitive OR substring), applied before charge. Example: Laborant, Chemiker, QC"" (no filter)

Sort Order

Control how job results are sorted:

OptionDescription
by_relevanceBest matches to your search query first (default)
by_dateNewest jobs first - recommended for job monitoring

Use by_date when you want to monitor for new job postings or get the latest opportunities.

Workload Filter (Pensum)

Filter jobs by workload percentage (Pensum in Swiss German):

ExampleDescription
workloadMin: 80Jobs with at least 80% workload
workloadMax: 60Part-time jobs up to 60%
workloadMin: 40, workloadMax: 60Part-time jobs between 40-60%

This is useful for finding part-time positions or full-time only jobs.

HR Company Filtering

Filter jobs by company type to focus on direct employer postings or recruitment agencies:

OptionDescription
allInclude all companies (default)
exclude-hrRemove HR/recruitment agencies (e.g., HP Job, Universal-Job, Adecco)
only-hrShow only HR/recruitment agency postings

The filter detects HR companies by matching company names against common patterns like "Personal", "Recruiting", "Staffing", "Job", "Vermittlung", "Zeitarbeit", etc.

Use cases:

  • Job seekers often prefer direct employer postings for more detailed job information
  • Recruiters may want to analyze competitor agency postings

Example Inputs

{
"searchQueries": ["Informatiker", "Softwareentwickler", "DevOps"],
"location": "St. Gallen",
"maxResultsPerQuery": 50,
"maxResults": 0
}
SEARCH MODE - Job Monitoring (Newest First)
{
"searchQueries": [""],
"location": "Thurgau",
"maxResultsPerQuery": 100,
"sortBy": "newest"
}
SEARCH MODE - Part-Time Jobs (40-60%)
{
"searchQueries": ["Buchhaltung"],
"location": "St. Gallen",
"workloadMin": 40,
"workloadMax": 60,
"maxResultsPerQuery": 50
}
SEARCH MODE - Exclude HR Agencies
{
"searchQueries": ["Elektriker"],
"location": "St. Gallen",
"maxResultsPerQuery": 100,
"companyFilter": "exclude-hr"
}
DIRECT URL MODE - Still Alive Checks
{
"directUrls": [
"https://www.nicejob.de/job/software-entwickler/12345",
"https://www.nicejob.de/job/projekt-manager/67890",
"https://www.nicejob.de/job/verkaufsberater/54321",
"https://www.nicejob.de/job/pflegefachfrau/11111"
]
}

Output

Each job listing follows the standardized JobListing schema:

{
"id": "12345",
"title": "Software Entwickler (m/w/d)",
"company": "Tech Solutions AG",
"location": "St. Gallen, 9000, SG",
"canton": "SG",
"job_status": "online",
"employment_type": "full-time",
"workload_min": 80,
"workload_max": 100,
"remote_option": null,
"description_snippet": "Wir suchen einen erfahrenen Entwickler...",
"description_full": "Taetigkeit: ...\n\nAnforderungen: ...\n\nWir bieten: ...",
"requirements": ["3+ Jahre Erfahrung in Java"],
"posted_at": "2024-01-15T00:00:00.000Z",
"expires_at": "2024-02-28T00:00:00.000Z",
"source_url": "https://www.nicejob.de/job/software-entwickler/12345",
"source_platform": "nicejob.de",
"contact_salutation": "Herr",
"contact_firstname": "Thomas",
"contact_lastname": "Mueller",
"contact_email": "jobs@techsolutions.ch",
"contact_phone": "+41712345678",
"contact_raw": "<strong>Kontakt:</strong><br/>Herr Thomas Mueller<br/>E-Mail: jobs@techsolutions.ch<br/>Tel: +41 71 234 56 78",
"apply_url": "https://careers.techsolutions.ch/apply",
"apply_email": "jobs@techsolutions.ch",
"company_url": "https://www.techsolutions.ch",
"company_description": "Tech Solutions AG ist ein fuehrender IT-Dienstleister...",
"company_social_urls": {
"linkedin": "https://linkedin.com/company/techsolutions",
"xing": "https://xing.com/companies/techsolutions"
},
"company_benefits": ["Flexible Arbeitszeiten", "Home Office", "Weiterbildung"],
"search_query": "Informatiker",
"scraped_at": "2024-01-16T12:00:00.000Z"
}

Output Fields

FieldDescription
job_statusJob availability status: "online" (still available), "offline" (removed/404). Only set in DIRECT URL mode.
search_queryThe search keyword that found this job (for multi-query tracking).
contact_rawRaw HTML/text contact block from the job posting (always populated)
contact_salutation"Herr" or "Frau"
contact_firstnameFirst name
contact_lastnameLast name
contact_positionJob title or role of the contact person (e.g. "HR Recruiting")
contact_emailEmail address - extracted via regex
contact_phonePhone number - extracted via regex
company_descriptionCompany about/description text (HTML stripped)
company_social_urlsObject with social media links (linkedin, xing, facebook, etc.)
company_benefitsArray of company benefits/perks (e.g., "Flexible Arbeitszeiten")

You are responsible for using the data lawfully, including the GDPR/DSGVO, national data-protection laws and unfair-competition rules (e.g. UWG) for marketing and outreach.

Job Status Values (DIRECT URL Mode)

When using directUrls, each job will have a job_status field:

ValueDescription
"online"Job is still available on nicejob.de, full data extracted
"offline"Job not found (404) or removed, minimal data returned

Usage

Via Apify Console

  1. Go to the actor page
  2. Configure input parameters
  3. Click "Start"
  4. Download results from the Dataset tab (JSON, CSV, Excel)

Via API

curl -X POST "https://api.apify.com/v2/acts/santamaria~nicejob-de-scraper/runs" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"searchQueries": ["Pflege", "Informatiker"],
"location": "Thurgau",
"maxResultsPerQuery": 100
}'

Via Apify SDK (Node.js)

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('santamaria/nicejob-de-scraper').call({
searchQueries: ['Buchhaltung', 'Informatiker'],
location: 'St. Gallen',
maxResultsPerQuery: 150,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} jobs`);

Still Alive Checks via API

// Check if previously scraped jobs are still online
const run = await client.actor('santamaria/nicejob-de-scraper').call({
directUrls: [
'https://www.nicejob.de/job/software-entwickler/12345',
'https://www.nicejob.de/job/projekt-manager/67890',
]
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(job => {
console.log(`Job ${job.id}: ${job.job_status}`);
// Output: "Job 12345: online" or "Job 67890: offline"
});

Covered Regions

Nicejob.de lists jobs mainly from Germany, plus Switzerland, Liechtenstein and Austria. Examples by canton:

CantonMajor Cities
SGSt. Gallen, Rapperswil, Wil
TGFrauenfeld, Kreuzlingen, Arbon
ARHerisau, Teufen
AIAppenzell
GRChur, Davos, St. Moritz
GLGlarus

Performance

  • Speed: ~100-200 jobs/minute (limited by respectful rate limiting)
  • Cost: ~0.01-0.03 CU per 500 jobs
  • Reliability: Built-in retry logic and error handling
  • Direct URL mode: ~1-2 seconds per URL check (4-second rate limit between requests)

Data Source

This actor scrapes data from a German job portal:

  • Website: nicejob.de
  • API: Public vacancy search API (https://api.nicejob.de/public/vacancy/)
  • Coverage: mainly Germany; the board also lists jobs in Switzerland, Liechtenstein and Austria, and country reflects the job's real country (DE, CH, LI or AT)

This actor accesses publicly available job listings through the API. Please ensure your use case complies with the nicejob.de terms of service.

Changelog

  • 1.5: location filter works again for cantons and districts (nicejob.de moved its API); an unresolved location is reported in the status message instead of silently searching everywhere.
  • 1.4: rows in Switzerland, Liechtenstein and Austria now carry country CH, LI or AT, including region-only locations (previously many were labelled DE).
  • 1.2.1: new input postedWithinDays; new input titleFilter (drops non-matching titles before saving and billing); connection handling over datacenter, residential and unblocker levels with exact data-volume counting; a run that is blocked on every level ends with a clear message and no charge; a job check that cannot be completed is skipped instead of reported offline; table view in the dataset tab; a run stops saving jobs once the max total charge you set is reached.

Working across the German job market? These complement Nicejob.de:

Germany

Switzerland

Austria

Global

Enrich your job data


Part of the Santamaria Job Scrapers Suite - Professional-grade job data for the DACH region and beyond. Need help with integration, aggregation, or custom scraping solutions? Contact us at contact@nanoscrape.com