{
  "openapi": "3.0.1",
  "info": {
    "title": "Remote Jobs Scraper - Himalayas, Remote OK, We Work Remotely",
    "description": "Remote jobs from Himalayas, Remote OK, We Work Remotely, Working Nomads, Arbeitnow and Jobicy via official APIs. Skills, working time zone, seniority, visa and relocation filters, yearly USD salary, dedupe. $0.80/1,000 jobs; filtered and duplicate jobs free.",
    "version": "0.1",
    "x-build-id": "0JgpIku7OtiuvZyPH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tinyrex~remote-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tinyrex-remote-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/tinyrex~remote-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tinyrex-remote-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/tinyrex~remote-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tinyrex-remote-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "keywords": {
            "title": "Job titles / keywords",
            "type": "array",
            "description": "Each keyword is a separate search, e.g. python, react developer, product designer, customer support. A job matches when every word of the keyword appears (see 'Match keywords in'). Leave empty to get the newest remote jobs.",
            "default": [
              "python"
            ],
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "title": "Job boards",
            "type": "array",
            "description": "Himalayas (largest, server-side search, salaries), Remote OK, We Work Remotely, Working Nomads, Arbeitnow (Europe/Germany) and Jobicy (salaries, last 7 days). All use their official public APIs or feeds.",
            "items": {
              "type": "string",
              "enum": [
                "himalayas",
                "remoteok",
                "weworkremotely",
                "workingnomads",
                "arbeitnow",
                "jobicy"
              ],
              "enumTitles": [
                "Himalayas",
                "Remote OK",
                "We Work Remotely",
                "Working Nomads",
                "Arbeitnow",
                "Jobicy"
              ]
            },
            "default": [
              "himalayas",
              "remoteok"
            ]
          },
          "maxResultsPerSearch": {
            "title": "Max jobs per keyword and board",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum jobs saved per keyword and job board. 0 = no limit.",
            "default": 50
          },
          "matchIn": {
            "title": "Match keywords in",
            "enum": [
              "title",
              "titleAndTags",
              "everywhere"
            ],
            "type": "string",
            "description": "Where the keyword words must appear.",
            "default": "titleAndTags"
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop jobs whose title, company, tags or categories contain any of these terms (case-insensitive substring). Filtered jobs are free. Empty = off.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Drop jobs whose company name contains any of these terms (case-insensitive substring). Filtered jobs are free. Empty = off. Prefer this over Exclude keywords when you only want to skip specific employers (e.g. staffing firms).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyWithCompany": {
            "title": "Only jobs with a company name",
            "type": "boolean",
            "description": "Keep only jobs that publish a non-empty company name. Filtered jobs are free.",
            "default": false
          },
          "countries": {
            "title": "Candidate countries",
            "type": "array",
            "description": "Only jobs open to candidates in these countries (names or ISO codes, e.g. Germany, US, Canada). Himalayas filters on the server; other boards are matched on their location text. Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeWorldwide": {
            "title": "Include 'worldwide / anywhere' jobs",
            "type": "boolean",
            "description": "With a country filter, also keep jobs open worldwide.",
            "default": true
          },
          "employmentType": {
            "title": "Employment type",
            "type": "array",
            "description": "Only these types. Jobs without a type on the board are kept.",
            "items": {
              "type": "string",
              "enum": [
                "fulltime",
                "parttime",
                "contract",
                "internship"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contract / freelance",
                "Internship"
              ]
            },
            "default": []
          },
          "seniority": {
            "title": "Seniority",
            "type": "array",
            "description": "Keep only these levels. Himalayas filters by its own levels; on the other boards the Actor uses the normalised seniorityLevel (board level, job title such as Senior/Junior/Lead/Head of, or the years of experience the ad asks for). Filtered jobs are free.",
            "items": {
              "type": "string",
              "enum": [
                "entry",
                "mid",
                "senior",
                "manager",
                "director",
                "executive"
              ],
              "enumTitles": [
                "Entry-level",
                "Mid-level",
                "Senior",
                "Manager",
                "Director",
                "Executive"
              ]
            },
            "default": []
          },
          "includeUnknownSeniority": {
            "title": "Keep jobs with unknown seniority",
            "type": "boolean",
            "description": "When a seniority filter is set, also keep jobs whose level cannot be determined (title and ad give no level). Turn off for a strict filter.",
            "default": true
          },
          "publishedWithinDays": {
            "title": "Published within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only jobs posted in the last N days. 0 = any time.",
            "default": 0
          },
          "onlyWithSalary": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Keep only jobs that publish a salary range (mostly Himalayas and Remote OK).",
            "default": false
          },
          "minYearlySalaryUsd": {
            "title": "Minimum yearly salary (USD)",
            "minimum": 0,
            "maximum": 2000000,
            "type": "integer",
            "description": "Keep only jobs whose published salary, converted to a yearly USD amount (ECB reference rates), reaches this value. Jobs without a salary are dropped when set. 0 = off. Filtered jobs are free.",
            "default": 0
          },
          "remoteScopes": {
            "title": "Remote scope",
            "type": "array",
            "description": "Keep only jobs with these remote scopes, read from each board's location data: <b>worldwide</b> (anywhere / not restricted), <b>regional</b> (several countries, a continent or a time-zone band), <b>country</b> (one country, state or city), <b>hybrid</b>, <b>onsite</b> (Arbeitnow non-remote jobs). Empty = all. Filtered jobs are free.",
            "items": {
              "type": "string",
              "enum": [
                "worldwide",
                "regional",
                "country",
                "hybrid",
                "onsite"
              ],
              "enumTitles": [
                "Worldwide",
                "Regional (several countries / continent / time zone)",
                "One country",
                "Hybrid",
                "On-site"
              ]
            },
            "default": []
          },
          "visaSponsorship": {
            "title": "Visa sponsorship",
            "enum": [
              "any",
              "offered",
              "notRefused"
            ],
            "type": "string",
            "description": "Read from the job ad text. <b>Only jobs that offer visa sponsorship</b> keeps ads that say they sponsor visas or work permits; <b>Drop jobs that refuse sponsorship</b> removes ads saying sponsorship is not available. Every job gets <code>visaSponsorship</code> (true / false / null = not mentioned) plus the sentence as proof. Filtered jobs are free.",
            "default": "any"
          },
          "onlyRelocationSupport": {
            "title": "Only jobs with relocation support",
            "type": "boolean",
            "description": "Keep only ads that mention a relocation package, assistance or help moving (<code>relocationSupport</code> = true). Filtered jobs are free.",
            "default": false
          },
          "onlyWithApplicationEmail": {
            "title": "Only jobs with an application email",
            "type": "boolean",
            "description": "Keep only jobs where an application or hiring email was found in the apply link or the ad text (<code>applicationEmail</code>). Filtered jobs are free.",
            "default": false
          },
          "onlyWithCompanyWebsite": {
            "title": "Only jobs with a company website",
            "type": "boolean",
            "description": "Keep only jobs where the employer's own website was found (a link in the ad or the apply URL whose domain matches the company name, or a company name like \"Lemon.io\"). Handy for lead lists: feed companyDomain into a contact or tech-stack tool. Jobs without one are skipped and free.",
            "default": false
          },
          "requiredSkills": {
            "title": "Required skills / tech stack",
            "type": "array",
            "description": "Keep only jobs that ask for these skills, e.g. Python, React, AWS, Kubernetes, Salesforce, Figma, SEO. Aliases work (golang, k8s, react.js, postgres). Matched against the normalised skills field (title, board tags and ad text); a term outside the built-in list of ~110 skills is searched as a whole word in the title, tags and description. Filtered jobs are free. Empty = off.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "skillsMatch": {
            "title": "Skills match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "any = the job needs at least one of the required skills; all = it needs every one of them.",
            "default": "any"
          },
          "workTimezone": {
            "title": "Your time zone (working hours filter)",
            "type": "string",
            "description": "Keep only jobs whose stated working time zones include yours, e.g. UTC+1, GMT-5, +5:30, CET or Europe/Berlin. Uses the board's time zone list (Himalayas) or an explicit line in the ad such as \"UTC-8 to UTC-4\", \"CET +/- 3 hours\" or \"US time zones\". Filtered jobs are free. Empty = off.",
            "default": ""
          },
          "timezoneFlexHours": {
            "title": "Time zone flexibility (hours)",
            "minimum": 0,
            "maximum": 12,
            "type": "integer",
            "description": "Accept jobs up to this many hours outside their stated window. The default 1 covers daylight saving time differences.",
            "default": 1
          },
          "includeUnknownTimezone": {
            "title": "Keep jobs with no time zone stated",
            "type": "boolean",
            "description": "Most ads do not name a time zone. On = keep them when the time zone filter is on (recommended); off = keep only jobs with a known window that fits.",
            "default": true
          },
          "includeDescription": {
            "title": "Include full job description",
            "type": "boolean",
            "description": "Adds the full description as plain text. Same price either way.",
            "default": true
          },
          "dedupeAcrossSources": {
            "title": "Remove cross-board duplicates",
            "type": "boolean",
            "description": "The same job is often posted on several boards. Keep only the first copy (same title + company). Duplicates are free.",
            "default": true
          },
          "arbeitnowRemoteOnly": {
            "title": "Arbeitnow: remote jobs only",
            "type": "boolean",
            "description": "Arbeitnow also lists on-site jobs in Germany. Keep only remote ones.",
            "default": true
          },
          "arbeitnowPages": {
            "title": "Arbeitnow: pages to read",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Arbeitnow has no search; the newest pages are read and filtered (about 300 jobs per page).",
            "default": 2
          },
          "jobicyPages": {
            "title": "Jobicy: pages to read",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Jobicy's feed covers the last 7 days; each page has up to 200 newest jobs, filtered locally.",
            "default": 2
          },
          "onlyNewJobs": {
            "title": "Only new jobs (monitoring)",
            "type": "boolean",
            "description": "Return only jobs not returned by previous runs with the same state key. Ideal for daily schedules. The first run returns everything.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name of the monitoring state. Use different keys for different schedules.",
            "default": "default"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed normally.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}