No Fluff Jobs Search Scraper

This Apify Actor collects publicly available No Fluff Jobs postings from the official nofluffjobs.com site. It uses the official HTTPS posting JSON endpoint and the official search page's structured SSR state. It does not use browser automation, residential proxies, third-party mirrors, or access-control bypasses.

What it returns

Each dataset item is a source-verified job record. When published by No Fluff, the record includes:

• stable posting reference and canonical detail URL;
• title, company, company URL/logo/size, category, seniority, and technology;
• every published location, city, province, address, country, coordinates, remote level, and workplace type;
• all published salary options, currencies, periods, contract types, holiday information, and disclosure status;
• description HTML and text, section headings, bullets, daily tasks, requirements, skills, methodology, benefits, equipment, and recruitment details;
• source record, field coverage, request receipts, and verification flags.

Missing source values are omitted. The Actor never writes null, blank, or placeholder fields and does not put diagnostics in the dataset. Structured diagnostics and run health are written to RUN_DIAGNOSTICS, RUN_SUMMARY, RUN_METADATA, and RUN_HEALTH in the default key-value store.

Modes

search is the default and accepts query, optional location, and language. Simple technology queries use the corresponding official category route; other searches use the official keyword search route.

single accepts one exact detail URL in url. multiple accepts exact detail URLs in urls. searchMultiple accepts an array such as { "query": "javascript", "location": "Warszawa" } in searches. startUrls accepts a mixture of official listing and detail URLs in startUrls.

All modes share maxItems, maxPages, maxCandidates, maxRequests, timeoutMs, and deadlineMs bounds. The default input is deliberately small so local QA completes quickly:

{
  "mode": "search",
  "query": "javascript",
  "language": "pl",
  "maxItems": 3,
  "maxPages": 1,
  "maxCandidates": 30,
  "maxRequests": 12,
  "timeoutMs": 15000,
  "deadlineMs": 150000,
  "retries": 0
}

Local development

npm ci
npm run check
npm test
npx apify-cli validate-schema .actor/input_schema.json
npx apify-cli run --purge --input-file INPUT.json
npm run validate

Local and Apify Cloud runs use the same bounded official-source workflow and expose truthful localOnly provenance.

Source boundary and responsible use

Only official HTTPS URLs on nofluffjobs.com are accepted. Search pages provide candidate slugs; each saved record is then verified against the official posting API. If the target blocks or removes a source, the Actor records the reason in KVS and skips the unverifiable item. Use the data lawfully, respect the site's terms and robots directives, and do not use this Actor to collect candidate or recruiter personal data.