{
  "openapi": "3.0.1",
  "info": {
    "title": "Remote Jobs API: Himalayas, Jobicy, RemoteOK & Arbeitnow",
    "description": "One feed of remote jobs from Himalayas, Jobicy, RemoteOK and Arbeitnow: filters, merged duplicates, a source link and attribution line on every row, and a new-only mode for schedules. No login, no proxy. Free during launch; from 1 November 2026: $1.50 per 1,000 jobs.",
    "version": "0.1",
    "x-build-id": "5fM4nIaUmEH6J0tqD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tinlark~remote-jobs-feed/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tinlark-remote-jobs-feed",
        "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/tinlark~remote-jobs-feed/runs": {
      "post": {
        "operationId": "runs-sync-tinlark-remote-jobs-feed",
        "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/tinlark~remote-jobs-feed/run-sync": {
      "post": {
        "operationId": "run-sync-tinlark-remote-jobs-feed",
        "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": "Job boards",
            "type": "array",
            "description": "Which boards to read. Default: all four. Remotive and We Work Remotely are not offered.",
            "items": {
              "type": "string",
              "enum": [
                "himalayas",
                "jobicy",
                "remoteok",
                "arbeitnow"
              ],
              "enumTitles": [
                "Himalayas",
                "Jobicy (last 7 days)",
                "Remote OK (latest 100)",
                "Arbeitnow (remote jobs only)"
              ]
            },
            "default": [
              "himalayas",
              "jobicy",
              "remoteok",
              "arbeitnow"
            ]
          },
          "keywords": {
            "title": "Keywords (any of)",
            "type": "array",
            "description": "Keep listings whose title, company, categories, tags or description contain any of these words (not case sensitive). Empty keeps everything.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop listings that contain any of these words.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Keep listings in these categories. Each board's own labels are mapped to this common list; the original labels stay in `tags`.",
            "items": {
              "type": "string",
              "enum": [
                "software-engineering",
                "devops-infrastructure",
                "data-ai",
                "design",
                "product",
                "marketing",
                "sales",
                "customer-support",
                "finance",
                "hr-recruiting",
                "legal",
                "operations-admin",
                "writing-content",
                "security",
                "education",
                "healthcare",
                "other"
              ],
              "enumTitles": [
                "Software engineering",
                "DevOps and infrastructure",
                "Data and AI",
                "Design",
                "Product",
                "Marketing",
                "Sales",
                "Customer support",
                "Finance and accounting",
                "HR and recruiting",
                "Legal and compliance",
                "Operations and admin",
                "Writing and content",
                "Security",
                "Education",
                "Healthcare",
                "Other"
              ]
            }
          },
          "countries": {
            "title": "Countries (ISO codes)",
            "type": "array",
            "description": "Two-letter codes such as US, DE or GB. Keeps listings that name the country, or a region that contains it (EMEA, Europe, LATAM). Matching is on the board's own location text. Worldwide listings are kept unless you turn off the next option.",
            "items": {
              "type": "string"
            }
          },
          "includeWorldwide": {
            "title": "Also keep worldwide listings",
            "type": "boolean",
            "description": "With a country filter: also return listings open to candidates anywhere.",
            "default": true
          },
          "jobTypes": {
            "title": "Job types",
            "type": "array",
            "description": "Keep these types. Listings whose board does not state a type are dropped when you pick one (RemoteOK rarely states it).",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "contract",
                "internship"
              ],
              "enumTitles": [
                "Full time",
                "Part time",
                "Contract / freelance",
                "Internship"
              ]
            }
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many job rows. Each job row is the billable event once pricing is active.",
            "default": 100
          },
          "newOnly": {
            "title": "New listings only",
            "type": "boolean",
            "description": "Return only listings you have not received before in runs that use the same State name, so a daily schedule stays cheap. The first run returns everything that matches.",
            "default": false
          },
          "stateName": {
            "title": "State name",
            "pattern": "^[A-Za-z0-9]([A-Za-z0-9-]{0,38}[A-Za-z0-9])?$",
            "type": "string",
            "description": "The name under which the Actor remembers which listings it has already delivered, kept in a named storage of your account. Letters, digits and hyphens, up to 40 characters. Use the same name on every scheduled run and a different name per watch list. Defaults to 'default' when New listings only is on."
          },
          "minSalaryUsd": {
            "title": "Minimum salary (USD per year)",
            "minimum": 0,
            "type": "integer",
            "description": "Keeps listings whose published salary reaches this yearly amount. Hourly, weekly and monthly pay is converted to a year. Only salaries stated in USD are compared; listings with no salary or another currency are dropped."
          },
          "timezones": {
            "title": "Time zones (UTC offsets)",
            "type": "array",
            "description": "Offsets such as -5, UTC+1 or UTC+05:30. Keeps listings open to candidates in any of them. Only Himalayas publishes time zones; listings from the other boards are dropped when you use this.",
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep listings published in the last N days."
          },
          "includeDescription": {
            "title": "Description",
            "enum": [
              "none",
              "text",
              "html"
            ],
            "type": "string",
            "description": "none: no description. text: plain text (default). html: the board's HTML.",
            "default": "text"
          },
          "dedupe": {
            "title": "Merge duplicates across boards",
            "type": "boolean",
            "description": "The same company and title on several boards becomes one row; the other boards are named in `alsoListedOn`. Duplicates are not charged.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}