Skip to main content
Version: Next

Working Nomads Extractor

What it is​

Original website: Working Nomads

This extractor uses Working Nomads' JSON search API rather than scraping rendered HTML pages.

Implementation split:

  1. extractors/workingnomads/src/run.ts posts search requests to https://www.workingnomads.com/jobsapi/_search, applies job-ops search and location controls, and maps returned rows into CreateJobInput.
  2. extractors/workingnomads/src/manifest.ts adapts pipeline settings, emits progress updates, and registers the source for runtime discovery.

Why it exists​

Working Nomads adds another remote-focused source without introducing credentials, browser automation, or brittle page scraping.

Using the JSON API keeps the integration small and more stable than scraping category pages, while still feeding normalized jobs into the existing discovery pipeline.

How to use it​

  1. Open Run jobs and choose Automatic.
  2. Leave Working Nomads enabled in Sources or toggle it on.
  3. Set your usual automatic run controls:
    • searchTerms are matched locally against title, employer, category, tags, location, and description.
    • selected country or city filters are applied after the API fetch.
    • workplace type is respected globally for the run.
    • run budget path (jobspyResultsWanted) is reused as a per-term cap.
  4. Start the run and monitor progress in the pipeline progress card.

Defaults and constraints:

  • No new credentials are required.
  • Working Nomads is a remote-only source, so it does not return meaningful hybrid-only or onsite-only results.
  • The upstream JSON search response is broad, so the extractor still applies local filtering for search-term matches and explicit city selection.
  • Job type is inferred from title and description when the API does not provide an explicit full-time, part-time, or contract field.

Common problems​

Working Nomads does not appear in sources​

  • Check that the app is running a build that includes the new extractor manifest and shared source metadata.
  • This source does not require credentials, so it should appear as soon as the updated build is loaded.

Results are broader than expected​

  • The upstream API is a broad remote jobs feed, so job-ops filters it after download.
  • Add more specific search terms or city filters when you want a narrower result set.

Hybrid or onsite runs return no Working Nomads jobs​

  • Working Nomads is integrated as a remote-only board.
  • Include remote in workplace type selection if you want this source to contribute jobs.