MyCareersFuture direct job search scraper

This Apify Actor extracts complete public jobs from MyCareersFuture, Singapore's public employment portal. It uses the official public JSON API at api.mycareersfuture.gov.sg directly, preserves source-backed employer, address, salary, skills, arrangement, metric, date, description, and provenance fields, and writes only detail-verified records to the dataset.

The Actor is bounded for predictable local execution. It supports search, single, multiple, searchMultiple, and startUrls modes. Search results are used to discover stable UUIDs, then the official job endpoint is fetched for each record for detail verification. Missing optional publisher fields are omitted.

Input

Example search:

{
  "mode": "search",
  "query": "software engineer",
  "maxItems": 3,
  "maxCandidates": 10,
  "maxPages": 1,
  "maxRequests": 10,
  "timeoutMs": 15000,
  "deadlineMs": 120000
}

The single mode accepts url, itemUrl, or jobId. Multiple accepts urls or jobIds. searchMultiple accepts searches or queries. startUrls accepts official API search/detail URLs and public MyCareersFuture web detail/search URLs. Existing query and maxItems inputs remain supported.

Output

Each dataset record includes stable job and posting IDs, title, employer details, company profile data, address and district, coordinates, categories, position and employment labels, skills, experience, vacancies, work arrangements, salary, full cleaned description and HTML, sections and bullets, requirements, posting/closing dates, metrics, official job URL, API source URL, source payload, detail verification, field coverage, quality metadata, and request receipts. applyUrl is emitted only when MyCareersFuture publishes a distinct application URL; the official job detail URL is never mislabeled as an application link.

Every local or Apify platform run also writes key-value records:

• RUN_SUMMARY — status, counts, runtime, request totals, and bounds.
• RUN_DIAGNOSTICS — access, HTTP, parse, identity, incomplete-detail, and budget diagnostics.
• RUN_METADATA — normalized input, official API policy, and request receipts.
• RUN_HEALTH — compact run health state.

Local QA

Run from this directory:

npm ci --ignore-scripts --no-audit --no-fund
npm test
npm run check
npx --yes apify-cli validate-schema .actor/input_schema.json
npx --yes apify-cli run --purge --input-file INPUT.json
npm run validate

The Actor supports local execution and Apify platform deployment. It does not use browser automation, proxies, or mirror services.

Cost and responsible use

maxItems, maxCandidates, maxPages, maxRequests, per-request timeouts, and the run deadline bound API traffic and compute use. Begin with the defaults and increase limits only when needed. Collect only public job data, respect applicable portal terms and laws, and verify the current source posting before applying.