Search remote jobs.

Lists remote jobs for one tag on Remote OK, like its tag page /remote-<tag>-jobs: title, company, location, tags, date, and link. The query is a single tag such as 'python', 'golang' or 'product', not free text. Returns the first page of the tag feed (about 100 jobs). Returns an empty list when the tag has no jobs.

No reports yetRead-only, no login

Site: Remote OK, United States
Version: v1
Runs, last 7 days: No reports yet
sha256: 926f039de690…

Run it with your agent

after installing Wield

Ask in plain words. Your agent finds this recipe and calls it:

“Search remote jobs.”

Read-only: it changes nothing on the site. No login needed.

{
  "tool": "run",
  "arguments": {
    "recipe_id": "remoteok.com/search-jobs",
    "params": {
      "query": "python"
    }
  }
}

Requests

sent from your browser, in order

1GET/remote-{{ params.query | lower }}-jobs.jsonThe tag page's JSON feed /remote-<tag>-jobs.json (the page links it as its JSON alternate). Read-only GET. The first array element is a legal notice without a position, so it is dropped.

Parameters

from your agent

querystringrequiredOne job tag, e.g. 'python', 'golang', 'product', 'devops'. Letters, digits and hyphens only; spaces are not supported.

Returns

to your agent

jobsobject[]company, date, location, tags, title, url

querystring

Where it can send

www.remoteok.com

Anything else is blocked by the extension.

Reads from your session

Nothing. Your browser attaches the site's cookies by itself.

Used only in requests to the addresses on the left. Never sent to wield.run or your agent.

Checks

a run passes when

length(output.jobs) > `0`
length(output.jobs[?starts_with(url, 'https://remoteok.com/remote-jobs/')]) == length(output.jobs)
length(output.jobs[?title != `null`]) == length(output.jobs)
length(output.jobs[?company != `null`]) > `0`

Raw recipe

Served as canonical JSON from /api/v1/recipes/remoteok.com/search-jobs, so its sha256 matches the ETag and the index.

Check it yourself

curl -s https://wield.run/api/v1/recipes/remoteok.com/search-jobs | shasum -a 256
# 926f039de6900762970bfb5d01ce75c41ee865d3dfcfa728bc31bb7ccc3cadbb

remoteok.com/search-jobs.json, v1

{
  "description": "Lists remote jobs for one tag on Remote OK, like its tag page /remote-<tag>-jobs: title, company, location, tags, date, and link. The query is a single tag such as 'python', 'golang' or 'product', not free text. Returns the first page of the tag feed (about 100 jobs). Returns an empty list when the tag has no jobs.",
  "effect": "read",
  "id": "remoteok.com/search-jobs",
  "keywords": [
    "remoteok",
    "remote ok",
    "remote jobs",
    "remote work",
    "jobs",
    "job board",
    "remote",
    "developer jobs",
    "remoteok.com",
    "hiring",
    "careers",
    "telecommute"
  ],
  "output": {
    "schema": {
      "properties": {
        "jobs": {
          "items": {
            "properties": {
              "company": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "Posting time, ISO-8601 with offset",
                "type": [
                  "string",
                  "null"
                ]
              },
              "location": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "tags": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "type": "string"
        }
      },
      "required": [
        "query",
        "jobs"
      ],
      "type": "object"
    },
    "value": "{query: params.query, jobs: steps.search.jobs[].{title: position, company: company || `null`, location: location || `null`, tags: tags || `[]`, date: date || `null`, url: join('', ['https://remoteok.com/remote-jobs/', slug])}}"
  },
  "params": {
    "additionalProperties": false,
    "properties": {
      "query": {
        "description": "One job tag, e.g. 'python', 'golang', 'product', 'devops'. Letters, digits and hyphens only; spaces are not supported.",
        "maxLength": 100,
        "minLength": 2,
        "pattern": "^[A-Za-z0-9-]+$",
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "provenance": {
    "method": "har",
    "notes": "The tag page /remote-python-jobs has an empty job table filled by script, and its search box filters client-side. Its linked JSON alternate /remote-<tag>-jobs.json returns the jobs as a plain GET with no key. Free-text search is not offered, so the query is a tag. Items come from that feed's position, company, location, salary and slug fields.",
    "recorded_at": "2026-11-08T15:45:00.000Z",
    "recorded_by": "wield-forge (claude-haiku agent)"
  },
  "requires_login": false,
  "schema": "https://wield.run/schema/recipe/v1.json",
  "site": {
    "country": "US",
    "id": "remoteok.com",
    "language": "en",
    "name": "Remote OK",
    "origin": "https://www.remoteok.com",
    "origins": [
      "https://www.remoteok.com"
    ]
  },
  "steps": [
    {
      "description": "The tag page's JSON feed /remote-<tag>-jobs.json (the page links it as its JSON alternate). Read-only GET. The first array element is a legal notice without a position, so it is dropped.",
      "expect": {
        "content_type": "json",
        "status": [
          200
        ]
      },
      "extract": {
        "json": {
          "jobs": "[?position]"
        }
      },
      "id": "search",
      "request": {
        "headers": {
          "Accept": "application/json"
        },
        "method": "GET",
        "url": "/remote-{{ params.query | lower }}-jobs.json"
      }
    }
  ],
  "task": "Search remote jobs",
  "tos": {
    "notes": "Not reviewed. One search page per call, the same page a visitor loads. The site's terms on automated access were not checked.",
    "reviewed": false
  },
  "verify": {
    "checks": [
      "length(output.jobs) > `0`",
      "length(output.jobs[?starts_with(url, 'https://remoteok.com/remote-jobs/')]) == length(output.jobs)",
      "length(output.jobs[?title != `null`]) == length(output.jobs)",
      "length(output.jobs[?company != `null`]) > `0`"
    ],
    "example_params": {
      "query": "python"
    },
    "max_ms": 5000
  },
  "version": 1
}