Randstad public jobs scraper

This Apify Actor retrieves complete, source-verified job records from Randstad's public global jobs pages. It uses bounded streaming HTTPS requests and parses the official page's embedded route data, JobPosting JSON-LD, semantic HTML, metadata, and public application link.

The Actor is local-test friendly and fail-closed: it never fabricates missing fields or treats a blocked or failed page as a dataset record; optional Apify Proxy routing is honored when configured.

Supported modes

• search: query the official jobs collection, follow detail pages, and return complete records.
• single: fetch one exact official Randstad job URL.
• multiple: fetch several exact official Randstad job URLs.
• jobUrls: compatibility alias that maps one URL to single and several URLs to multiple.

Search defaults to:

https://www.randstad.com/jobs/q-developer/

Direct URLs must use www.randstad.com or randstad.com and end with a numeric job ID. The Actor accepts query, keyword, location, startUrls, jobUrl, jobUrls, jobs, maxItems, maxCandidates, maxPages, timeoutMs, retries, and maxRequests. Optional Apify Proxy configuration is honored; legacy browser and concurrency controls are not exposed.

Dataset

Every emitted item is a complete record with a stable recordId and verified canonical job URL. Required identity and quality fields include:

• recordId, jobId, title, jobUrl, canonicalUrl
• companyName, companyId, accountId
• location, city, region, country, countryCode, postalCode, coordinates, remote
• employmentType, workingHours, role, industry, sector, specialism
• salary, salaryMin, salaryMax, salaryCurrency, salaryPeriod, benefits
• description, descriptionHtml, headings, sections, bullets, links, responsibilities, requirements, qualifications, skills
• published, modified, and expiration dates
• contact details are recursively redacted from descriptions and embedded source records
• sourceRecord, request receipt, field coverage, data quality, and verification metadata

Unavailable optional values are omitted. Empty strings, nulls, placeholder text, empty arrays, and empty objects are removed. Records are written only after identity, detail, source, HTTP, and minimum-description checks pass.

Run state is written to the local key-value store under RUN_SUMMARY, RUN_DIAGNOSTICS, RUN_METADATA, and RUN_HEALTH. These records include request receipts, retry counts, blocked-source signals, runtime, and accurate executionEnvironment, localOnly, apifyCallUsed, and apifyPushUsed markers.

Local commands

Install from the lockfile:

npm ci --ignore-scripts --no-audit --no-fund

Run static checks and unit tests:

npm test
npm run check

Run the bounded primary fixture:

apify run --purge --input-file INPUT.json
npm run validate

The repository also includes INPUT-single.json and INPUT-multiple.json for direct-detail mode checks. Local validation inspects the actual storage/datasets/default records and all four key-value store state files.

Responsible use

Use only publicly accessible Randstad pages and respect the site's terms, robots guidance, rate limits, and applicable law. This Actor does not bypass authentication, CAPTCHA, paywalls, or access controls.

Cloud execution and privacy

The Actor runs locally and on Apify, supports optional Apify Proxy routing, caps response bodies and request attempts, and recursively redacts email addresses and phone numbers from emitted records. Use proxy access only when needed and within your authorized budget.