Remote OK Jobs Scraper — official API, one request per run

Pull the latest remote job listings from Remote OK's own public API. One row per job, filtered locally, so a run is a single HTTP request no matter how you filter it.

Before you use the data: the link-back requirement

Remote OK publishes its API with terms attached, returned inside the response itself:

"Please link back (with follow, and without nofollow!) to the URL on Remote OK and mention Remote OK as a source, so we get traffic back from your site. If you do not we'll have to suspend API access. Please don't use the Remote OK logo without written permission as it's a registered trademark, please DO use our name Remote OK though."

So if you publish or display this data:

• Link to the url field with a followed link (no rel="nofollow").
• Credit "Remote OK" as the source. Every row carries source: "Remote OK" so you cannot lose track of where a record came from.
• Do not use the Remote OK logo. This Actor returns no logo of any kind, so you will not ship one by accident. Using the name is explicitly allowed.

The terms as returned at run time are saved in the run summary (apiTermsAtRunTime), so you always have the version you actually operated under.

What you get per job

Field	Example
position, company	Senior Backend Engineer, Acme
location	Orem, UT
tags	["dev", "senior", "digital nomad"]
salaryMinUsd / salaryMaxUsd	150000 / 200000
salaryDisclosed	false for most listings — see below
postedAt, ageInDays	ISO timestamp, 1.4
url, applyUrl	the Remote OK page and the apply destination
source	Remote OK

Salary is published as 0 when it is not disclosed. Those come back as null, never as a zero salary, and salaryDisclosed tells you which is which. In testing 1 of 99 listings disclosed pay — treat any salary analysis from this board as based on a very small slice, and the run summary reports the rate so you can see it.

Text encoding is repaired. Remote OK ships some records double-encoded — St John’s instead of St John's, and Arabic place names as mojibake. This Actor detects and fixes that, and leaves anything it cannot confidently repair untouched rather than mangling it further.

Input

{
  "tag": "dev",
  "term": "",
  "maxItems": 100
}

tag matches a tag exactly; term matches text in the title, company or tags. Both are optional. The API returns the latest 100 listings, and filtering runs on that batch — so narrowing your filter returns fewer rows, not more pages.

You are charged per job returned, so a tight filter costs less.

Summary (key-value store, SEARCH_SUMMARY)

totalJobs, availableBeforeFilter, uniqueCompanies, salaryDisclosureRate, source, attribution, apiTermsAtRunTime.

Limits, stated plainly

• The API exposes the latest 100 listings. There is no pagination and no historical archive, so this is a snapshot of what is current.
• Filtering is done on that batch. A rare tag may return only a handful of rows.
• Only job listings are read. Nothing about applicants is collected.

Unofficial; not affiliated with Remote OK. Uses the Remote OK public API under its stated terms.