{
  "openapi": "3.0.1",
  "info": {
    "title": "RemoteOK Jobs Scraper",
    "description": "[💰 $1.0 / 1K] Extract remote jobs from RemoteOK by category, keyword, salary, tags, location, and posted-within window. Returns structured data with normalized salaries, ISO dates, and clean descriptions.",
    "version": "1.0",
    "x-build-id": "WwaDCjM4fw8nIUuEn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~remoteok-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-remoteok-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/solidcode~remoteok-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-remoteok-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/solidcode~remoteok-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-remoteok-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": {
          "categories": {
            "title": "Categories",
            "uniqueItems": true,
            "type": "array",
            "description": "Pick one or more RemoteOK categories and skill tags — each one is scraped as its own search. Covers the 17 headline categories plus the most-requested skill tags (Python, Developer, React, Full stack, Virtual assistant, and more). RemoteOK has hundreds of other tags: to use one that isn't listed here, paste its page URL into RemoteOK URLs below, for example https://remoteok.com/remote-rust-jobs. Leave empty to pull from the global feed only.",
            "items": {
              "type": "string",
              "enum": [
                "engineer",
                "software",
                "technical",
                "senior",
                "lead",
                "management",
                "design",
                "marketing",
                "growth",
                "sales",
                "support",
                "product",
                "ops",
                "finance",
                "data",
                "data science",
                "writing",
                "non-tech",
                "python",
                "dev",
                "javascript",
                "react",
                "full stack",
                "backend",
                "front end",
                "devops",
                "java",
                "golang",
                "php",
                "ruby",
                "sql",
                "cloud",
                "mobile",
                "infosec",
                "sys admin",
                "testing",
                "ai",
                "machine learning",
                "junior",
                "analyst",
                "virtual assistant",
                "excel",
                "seo",
                "hr",
                "legal",
                "medical",
                "teaching"
              ],
              "enumTitles": [
                "Engineering",
                "Software development",
                "Technical",
                "Senior",
                "Lead",
                "Management",
                "Design",
                "Marketing",
                "Growth",
                "Sales",
                "Customer support",
                "Product",
                "Operations",
                "Finance",
                "Data entry",
                "Data science",
                "Content writing",
                "Non-tech",
                "Python",
                "Developer",
                "JavaScript",
                "React",
                "Full stack",
                "Backend",
                "Front end",
                "DevOps",
                "Java",
                "Golang",
                "PHP",
                "Ruby",
                "SQL",
                "Cloud",
                "Mobile",
                "Information security",
                "Sysadmin",
                "Testing & QA",
                "AI",
                "Machine learning",
                "Junior",
                "Analyst",
                "Virtual assistant",
                "Excel",
                "SEO",
                "HR & recruiting",
                "Legal",
                "Medical & healthcare",
                "Teaching & education"
              ]
            }
          },
          "searchUrls": {
            "title": "RemoteOK URLs",
            "type": "array",
            "description": "Paste any RemoteOK URL — for example https://remoteok.com/remote-jobs, a category page like https://remoteok.com/remote-python-jobs, or https://remoteok.com/api. Each URL is scraped separately. Optional.",
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Only keep jobs whose title, company name, tags, or description contain this text. Case-insensitive. Leave empty to skip."
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of unique jobs to return across all sources, counted AFTER your filters are applied — ask for 200 and you get up to 200 matching jobs. Set to 0 for unlimited. If RemoteOK runs out of matching jobs first you'll get fewer, and the run summary tells you why."
          },
          "requiredTags": {
            "title": "Required Tags",
            "type": "array",
            "description": "Only return jobs that include ALL of these tags (e.g. python, react, senior). Case-insensitive. Leave empty to skip.",
            "items": {
              "type": "string"
            }
          },
          "minSalaryUSD": {
            "title": "Minimum Salary (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs whose maximum advertised salary is at least this much (USD per year). Jobs without salary data pass through. Leave empty for no filter."
          },
          "postedWithin": {
            "title": "Posted Within",
            "enum": [
              "any",
              "24h",
              "7d",
              "30d",
              "90d"
            ],
            "type": "string",
            "description": "Only include jobs posted within this time window."
          },
          "locationContains": {
            "title": "Location Contains",
            "type": "string",
            "description": "Match on where the job may be worked FROM (its geographic restriction), not the employer's office city. Most remote jobs read \"Anywhere\"; the rest name a country. Values that work: anywhere, united states, canada, united kingdom, india, australia. Case-insensitive. Jobs with no location listed are skipped while this is set. Leave empty to skip. The employer's city, when RemoteOK publishes one, is returned separately in the locationText field."
          },
          "includeGlobalFeed": {
            "title": "Include Global Feed",
            "type": "boolean",
            "description": "Also pull https://remoteok.com/api (the latest jobs across all categories) and merge with category results. Turn off if you only want a specific category page or URL."
          },
          "stripHtml": {
            "title": "Include Plain-Text Description",
            "type": "boolean",
            "description": "Emit a clean plain-text descriptionText field alongside the HTML description. Turn off to skip the cleanup step and shrink output size."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}