Jobs SHZ vacancy scraper

Turn a Jobs SHZ keyword or public listing URL into one structured vacancy record per job. Recruitment teams, staffing researchers, and regional labor-market analysts receive the employer, location, job category, work arrangement, dates, public description, and source URL required to assess an opportunity in Schleswig-Holstein.

Best fit for this Actor

• Start with a German role keyword such as Pflegefachkraft, Elektroniker, or Softwareentwickler, or provide a public jobs.shz.de search/job URL.
• Select concise for compact agent-ready records and detailed for richer public job descriptions.
• Use one focused query per run and set maxResults to the number of vacancies your workflow can evaluate.

Standalone workflow

This actor works as a focused standalone workflow for Jobs SHZ, the regional Schleswig-Holstein board reached through jobs.sh.

Workflow: monitor nursing vacancies in Schleswig-Holstein

A staffing researcher starts with Pflegefachkraft and requests 20 records. The actor reads the live Jobs SHZ search pages, follows each public vacancy page, and returns title, employer, location, posting date, and public source URL. The researcher can then export the dataset, compare active employers, and keep the source URLs for a later freshness check.

Quick start input

{
  "searchQuery": "Pflegefachkraft",
  "maxResults": 20,
  "includeJobDetails": true,
  "responseFormat": "concise"
}

searchQuery uses the live Jobs SHZ public index. maxResults limits returned rows and establishes the maximum number of billable vacancy events for that run.

Input reference

Field	Type	What it controls
searchQuery	string	A Jobs SHZ keyword, for example Pflegefachkraft; blank collects the newest listings.
startUrls	array	Public Jobs SHZ search or job-detail URLs; these override the keyword when supplied.
maxResults	integer	A 1–200 record cap; default 20.
includeJobDetails	boolean	Opens each public vacancy page for its description and richer fields; default true.
responseFormat	enum	concise limits description text to 1,200 characters; detailed allows 8,000 characters.

What data you receive

Every dataset item represents one public Jobs SHZ vacancy. Stable semantic fields include jobId, title, companyName, location[], occupationalFields[], remoteOptions[], postedAt, applicationUrl, sourceUrl, and scrapedAt.

{
  "jobId": "1990313",
  "title": "Elektroniker für IT-gestützte Systeme (m/w/d)",
  "companyName": "Example GmbH",
  "location": ["Kiel, Deutschland"],
  "occupationalFields": ["Elektrotechnik"],
  "postedAt": "ISO 8601 publication timestamp",
  "sourceUrl": "https://jobs.shz.de/job/example-1990313",
  "scrapedAt": "ISO 8601 collection timestamp",
  "source": "jobs-shz"
}

The sourceUrl identifies the canonical public vacancy page and supports freshness checks. scrapedAt records the collection time. When a result cap truncates a search, narrow the keyword or use an additional focused query for the next page of work.

Use through the API

Start an execution with your Apify token, then read the default dataset linked in the completed execution response.

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~jobs-sh-scraper/runs?token=<APIFY_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{"searchQuery":"Pflegefachkraft","maxResults":20,"responseFormat":"concise"}'

Use the returned default dataset URL to export JSON, CSV, XLSX, or another Apify dataset format.

Use with AI agents through Apify MCP

Find up to 20 current nursing vacancies on Jobs SHZ. Return the title, employer, location, posting date, and public source URL as concise records.

After the call, inspect OUTPUT.outcome, read the default dataset, and preserve sourceUrl plus scrapedAt in downstream decisions. Set a bounded maxResults before an agent runs the actor. Use Apify MCP for current client-specific setup.

Pricing

This Actor uses Pay per event. It charges $0.003 per validated vacancy and $0.00005 per actor start; these event prices cover the platform usage for this Actor. Open the live pricing tab for the current event details and use maxResults plus Apify run cost controls to keep the workflow aligned with your budget.

Best results

• Use the German role vocabulary that candidates and employers use on Jobs SHZ, such as Pflegefachkraft or Elektroniker.
• Keep one role or research question per run, then export each bounded dataset for clear comparisons.
• Enable job details when descriptions, company pages, or application workflow signals matter to the decision.
• Retain sourceUrl and scrapedAt whenever a workflow needs repeatable provenance or freshness checks.

Builder's note

I designed this actor around the structured data Jobs SHZ renders into every public Next.js page before the browser executes its interface. In my testing, reading that server-rendered payload and validating each normalized row before storage kept the output stable while supporting the normal search and detail workflow without a browser dependency.

Responsible use

Use public or authorized data in accordance with applicable terms and laws. Keep vacancy records connected to legitimate recruitment, market research, and job-monitoring workflows.