{
  "openapi": "3.0.1",
  "info": {
    "title": "Remote Jobs Scraper: $0.35 per 1,000 Jobs",
    "description": "Combine public remote job feeds in one searchable dataset. Filter by keyword, category, location, timezone, salary and date. Get source credits, cleaned descriptions, application links and new-job tracking. $0.35 per 1,000 jobs.",
    "version": "0.1",
    "x-build-id": "7anrvzg0JeSPAcavN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zaiq~remote-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zaiq-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/zaiq~remote-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zaiq-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/zaiq~remote-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zaiq-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": {
          "sources": {
            "title": "Sources",
            "type": "array",
            "description": "Public feeds to combine. Empty uses Remote OK, We Work Remotely and Jobicy. Arbeitnow and Arbeitnow UK are optional and retain only records explicitly marked remote. Feed data is cached for one hour.",
            "items": {
              "type": "string",
              "enum": [
                "remoteok",
                "weworkremotely",
                "jobicy",
                "arbeitnow",
                "arbeitnow-uk"
              ]
            },
            "default": [
              "remoteok",
              "weworkremotely",
              "jobicy"
            ]
          },
          "keywords": {
            "title": "Keywords or phrases",
            "type": "array",
            "description": "Optional literal, case-insensitive phrases. Any phrase matches by default; use All for AND. Empty returns the newest jobs in the scanned feeds.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "keyword": {
            "title": "Single keyword",
            "type": "string",
            "description": "Optional shortcut for one keyword or phrase, combined with Keywords.",
            "default": ""
          },
          "keywordMode": {
            "title": "Keyword matching",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "Match any requested phrase or require all of them.",
            "default": "any"
          },
          "searchIn": {
            "title": "Search in",
            "enum": [
              "title",
              "all"
            ],
            "type": "string",
            "description": "Title is more precise; All also searches company, tags and cleaned description.",
            "default": "title"
          },
          "sortBy": {
            "title": "Result order",
            "enum": [
              "balanced",
              "newest"
            ],
            "type": "string",
            "description": "Balanced takes the newest match from each source in turn. Newest sorts the whole scanned window by date.",
            "default": "balanced"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Optional normalized categories inferred from the title and source categories/tags. Choose one or more; empty keeps all.",
            "items": {
              "type": "string",
              "enum": [
                "software",
                "data",
                "design",
                "marketing",
                "sales",
                "support",
                "product",
                "operations",
                "finance",
                "hr",
                "writing",
                "other"
              ]
            },
            "default": []
          },
          "locations": {
            "title": "Location eligibility",
            "type": "array",
            "description": "Optional countries, regions or literal place names. Country aliases include US, UK, DE, CA and ZA. Explicit worldwide jobs also match; unknown or conflicting rules are excluded unless enabled below. This is a source-label filter, not a work-authorization decision.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "includeUnknownLocation": {
            "title": "Include unclear location rules",
            "type": "boolean",
            "description": "When a location filter is set, also allow missing or conflicting location evidence. Such rows carry notes and a review verdict.",
            "default": false
          },
          "timezone": {
            "title": "UTC offset",
            "type": "string",
            "description": "Optional UTC offset, e.g. UTC+02:00. Matches explicit UTC/GMT offsets or ranges in the listing; named zones are retained as text and are not guessed.",
            "default": ""
          },
          "includeUnknownTimezone": {
            "title": "Include jobs without explicit UTC rules",
            "type": "boolean",
            "description": "When filtering timezone, also include jobs whose description has no interpretable UTC/GMT rule.",
            "default": false
          },
          "salaryMin": {
            "title": "Minimum published salary",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "number",
            "description": "Minimum of the published range, in Salary currency and Salary period. Zero disables this filter. Unknown amounts, currencies and periods are excluded when filtering. No currency conversion or hourly-to-annual assumptions.",
            "default": 0
          },
          "salaryCurrency": {
            "title": "Salary currency",
            "type": "string",
            "description": "Three-letter currency code used only for the salary filter.",
            "default": "USD"
          },
          "salaryPeriod": {
            "title": "Salary period",
            "enum": [
              "year",
              "month",
              "week",
              "day",
              "hour"
            ],
            "type": "string",
            "description": "Compare only salaries with this published pay period.",
            "default": "year"
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Keep jobs posted in this many days; zero disables the date filter. This cannot recover jobs outside the source feed window.",
            "default": 0
          },
          "jobTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Optional source-stated employment types. Unknown types are excluded when filtering.",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "contract",
                "internship",
                "temporary",
                "freelance"
              ]
            },
            "default": []
          },
          "maxResults": {
            "title": "Maximum jobs",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum unique paid jobs delivered in total, including rows already delivered before a restart. Notes do not count. Results follow Result order within the scanned feed window.",
            "default": 50
          },
          "maxPagesPerSource": {
            "title": "Maximum pages per source",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Maximum sequential pages to scan from each paginated source (up to 25). Stops sooner once that source has enough matching unseen jobs for the affordable result target. Remote OK and We Work Remotely each publish a single rolling feed. SUMMARY flags unscanned pages; absence never proves closure.",
            "default": 3
          },
          "includeDescription": {
            "title": "Include cleaned descriptions",
            "type": "boolean",
            "description": "Return descriptions as plain text. Turning this off reduces dataset size; descriptions arrive inside the feed so it does not reduce source requests.",
            "default": true
          },
          "mode": {
            "title": "Output mode",
            "enum": [
              "search",
              "new"
            ],
            "type": "string",
            "description": "Search returns current matches. New returns only previously undelivered matching source IDs, using the named state store below. The first new-only run delivers its baseline.",
            "default": "search"
          },
          "stateStoreName": {
            "title": "New-job state store",
            "type": "string",
            "description": "Required for New mode. Use an Apify key-value store name you own and reuse it on later runs. Run the same alert sequentially; concurrent runs can duplicate alerts.",
            "default": ""
          },
          "alertKey": {
            "title": "Alert name",
            "type": "string",
            "description": "Separate alerts in the same state store. Filters are included in the state key; changing filters starts a separate baseline.",
            "default": "default"
          },
          "cacheStoreName": {
            "title": "Feed cache store",
            "type": "string",
            "description": "Reusable named key-value store in your account. Reuse this name across schedules to honor hourly feed refreshes. Do not schedule overlapping refreshes.",
            "default": "remote-jobs-feeds-v1"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}