{
  "openapi": "3.0.1",
  "info": {
    "title": "Remote OK Jobs Scraper: Only New Remote Jobs",
    "description": "Get remote job postings from Remote OK in one clean schema: title, company, location, tags, salary range, date and the link back to each job. Filter by tag and keywords. On scheduled runs, pay only for new or changed jobs. No personal-data fields.",
    "version": "0.2",
    "x-build-id": "bn61guqGjBwvCEmzg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/quicksloth~remoteok-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-quicksloth-remoteok-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/quicksloth~remoteok-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-quicksloth-remoteok-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/quicksloth~remoteok-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-quicksloth-remoteok-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": {
          "tags": {
            "title": "Tags",
            "maxItems": 50,
            "type": "array",
            "description": "Optional. Remote OK tags: an array of strings, one tag per entry (one per line in the form), up to 50, written as in the tag pages of remoteok.com (python, devops, design, customer-support; case does not matter and spaces become dashes). Each tag returns about its latest 100 jobs. Leave empty for the latest jobs of all tags. Example: [\"python\", \"devops\"]. Keep the url field of each job when you show the jobs to people: Remote OK asks for a link back.",
            "items": {
              "type": "string"
            }
          },
          "titleKeywords": {
            "title": "Title keywords",
            "type": "array",
            "description": "Optional, recommended. Words to look for in the job title: an array of strings. A job is kept if its title contains at least one of them (case-insensitive, part of a word is enough). Remote OK tags are broad, so this is the best way to get only the roles you want. Empty = all titles.",
            "items": {
              "type": "string"
            }
          },
          "locationKeywords": {
            "title": "Location keywords",
            "type": "array",
            "description": "Optional. Words to look for in the job's location: an array of strings (case-insensitive, any one is enough). The location is free text written by the employer (\"London\", \"Remote - US\", \"Worldwide\") and often empty, so this filter keeps few jobs: prefer tags and titleKeywords, and avoid short words that match inside longer ones.",
            "items": {
              "type": "string"
            }
          },
          "includeDescription": {
            "title": "Include job description",
            "type": "boolean",
            "description": "Optional, true or false (default false). true adds the full job description as plain text in the descriptionText field. Descriptions are the employer's own text: email addresses, phone numbers in common formats and names after labels such as \"Recruiter:\" are removed, but other mentions of people may remain. Makes the dataset much larger: leave it false unless you need the text.",
            "default": false
          },
          "onlyNewJobs": {
            "title": "Only new or changed jobs",
            "type": "boolean",
            "description": "Optional, true or false (default false). For scheduled runs: true returns only jobs that are new or have changed since the previous run with the same tags and filters (or the same stateKey). The first run returns everything within your limits and remembers what it returned, so a test run with this on also fills the history: give tests their own stateKey. You pay only for what is returned.",
            "default": false
          },
          "stateKey": {
            "title": "History name (for \"only new jobs\")",
            "pattern": "^[a-zA-Z0-9_-]*$",
            "maxLength": 60,
            "type": "string",
            "description": "Optional. A name for the \"only new jobs\" history: letters, digits, - and _ only, up to 60 characters. Give each scheduled task its own name so their histories stay separate; without a name, runs with the same tags and filters share one history, and changing the tags starts a new one."
          },
          "maxResults": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Optional integer. Stop after this many jobs in total; you pay only for the jobs saved. Empty or 0 = no limit (the run also stops at the maximum cost you set). The Console form is prefilled with 100. Runs started through the API or an AI agent have no job limit of their own (only the 100 jobs per run of the free plan, and any maxTotalChargeUsd you set)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}