RemoteOK Public Jobs Search Scraper

This Apify Actor extracts complete public job postings from RemoteOK. It discovers current listings from the official public /api feed and verifies each emitted record against the public job page's JobPosting JSON-LD using bounded native HTTPS requests and Cheerio. It does not use a browser, proxy, fingerprint spoofing, CAPTCHA solver, or authenticated access.

Modes

• search: fetch one official API collection, filter by query/location, and verify matching details.
• searchMultiple: fetch several official API URLs and deduplicate jobs by canonical URL.
• single: resolve one exact official RemoteOK job URL against the current API and verify its detail page.
• multiple: resolve several exact official RemoteOK job URLs against the current API and verify their detail pages.
• startUrls: classify a mixed list of official API and job URLs.

Input

The complete schema is in .actor/input_schema.json. A minimal search input is:

{
  "mode": "search",
  "query": "developer",
  "location": "",
  "maxItems": 3
}

maxPages, maxCandidates, maxConcurrency, timeoutSecs, maxRetries, and maxRequests bound local work. includeDescription includes the published description HTML plus text, headings, sections, bullets, and external links. includeRaw retains the source API job object.

Dataset output

Only complete API-and-detail-verified records are written to the default dataset. Records include stable IDs, title, company/logo, locations, remote status, employment and classification fields when published, tags, descriptions, benefits, salary/date fields, application state/instructions, canonical URLs, HTTP provenance, and verification flags. The source job URL is retained as jobUrl/offerUrl; applyUrl is retained only when published by RemoteOK or the detail page, and no application URL is fabricated.

Run evidence is stored in the default key-value store:

• RUN_SUMMARY — mode, counts, request budget, field coverage, status, and runtime.
• RUN_DIAGNOSTICS — structured access, parsing, request, identity, and validation diagnostics.
• RUN_METADATA — public-source transport and privacy metadata.

Local checks

npm ci
npm test
npm run check
apify run --purge --input-file INPUT.json
npm run validate

No apify call or apify push is required for local operation.

Deployment and traceability

This actor is inventory position 241 and reports actor version 2.1.0 in every dataset record and run summary. It uses only the official public RemoteOK API and public JobPosting pages, with a hard request budget, response-size guard, and no proxy or authenticated access.

Local validation is the supported pre-deployment gate. A cloud release requires an authenticated organization account with the intended Actor mapping; do not substitute a personal Actor. Use apify push only after that account and mapping are available.