{
  "openapi": "3.0.1",
  "info": {
    "title": "Himalayas Remote Jobs Scraper: Salaries, Timezones, Apply Links",
    "description": "Scrape Himalayas (himalayas.app) remote jobs by keyword, category, company, country, timezone and seniority: one row per job with salary range, countries and timezones it is open to, posted date, apply link and full description. No login, no API key.",
    "version": "0.1",
    "x-build-id": "JsNUWWCrgVsJEQyDE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~himalayas-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-himalayas-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/themineworks~himalayas-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-himalayas-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/themineworks~himalayas-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-himalayas-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": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles, skills or keywords, one per line, as you would type them in the Himalayas search box. Example: software engineer, react, customer support, product designer. Each keyword is one search. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "The most jobs to return for each keyword, category or link, 1 to 20,000. Himalayas shows up to 5,000 jobs per search (250 pages of 20); the full feed (no keyword) goes deeper. Example: 500.",
            "default": 50
          },
          "country": {
            "title": "Country the candidate lives in",
            "type": "string",
            "description": "Only jobs open to people in this country, for example United States, Germany, India, UK or a code such as DE. Worldwide jobs are included unless you tick 'Exclude worldwide jobs'. Leave empty for every country."
          },
          "worldwideOnly": {
            "title": "Worldwide jobs only",
            "type": "boolean",
            "description": "Only jobs open to candidates in any country. Overrides the country.",
            "default": false
          },
          "excludeWorldwide": {
            "title": "Exclude worldwide jobs",
            "type": "boolean",
            "description": "With a country set: only jobs that name that country, not the ones open to everyone.",
            "default": false
          },
          "seniority": {
            "title": "Seniority",
            "type": "array",
            "description": "Only jobs at these levels. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "Entry-level",
                "Mid-level",
                "Senior",
                "Manager",
                "Director",
                "Executive"
              ]
            }
          },
          "employmentTypes": {
            "title": "Employment type",
            "type": "array",
            "description": "Only jobs of these types. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "Full Time",
                "Part Time",
                "Contractor",
                "Temporary",
                "Intern",
                "Volunteer",
                "Other"
              ]
            }
          },
          "timezone": {
            "title": "Timezone",
            "type": "string",
            "description": "Only jobs that accept people in this UTC offset, for example UTC+05:30, UTC-5, -5 or 1. Leave empty for any timezone."
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Job categories, one per line, for example Developer, Design, Marketing, Sales, Customer Service, Data Science, Product, Finance, Human Resources, Operations, Legal. With keywords, only jobs in these categories are kept. Without keywords, each category is one search.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "Only jobs at these companies: the company name as it is in its Himalayas link, or the link itself, for example superside or https://himalayas.app/companies/gitlab. With no keyword you get every open job at these companies.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Himalayas links",
            "type": "array",
            "description": "Paste Himalayas links: a jobs page (https://himalayas.app/jobs/python, https://himalayas.app/jobs/countries/germany), a company (https://himalayas.app/companies/superside) for all its open jobs, or one job (https://himalayas.app/companies/superside/jobs/solutions-engineer).",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevant",
              "recent",
              "salaryDesc",
              "salaryAsc",
              "nameAToZ",
              "nameZToA"
            ],
            "type": "string",
            "description": "Order of the search results.",
            "default": "relevant"
          },
          "postedWithinDays": {
            "title": "Posted or updated in the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only jobs posted or updated in the last N days, for example 1 for a daily run or 7 for a weekly run. Leave empty for any date."
          },
          "onlyWithSalary": {
            "title": "Only jobs that show a salary",
            "type": "boolean",
            "description": "Skip jobs with no salary range. Skipped jobs are not charged.",
            "default": false
          },
          "includeDescriptionHtml": {
            "title": "Also return the description as HTML",
            "type": "boolean",
            "description": "Every row has the full description as plain text. Turn this on to get the original HTML too (larger rows).",
            "default": false
          },
          "apiKey": {
            "title": "Your Himalayas API key (optional)",
            "type": "string",
            "description": "Not needed. Without a key Himalayas answers about 30 pages (600 jobs) a minute. A free key from himalayas.app raises that to 60 pages a minute; paste it here only for very large runs."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}