{ "openapi": "3.0.1", "info": { "title": "Himalayas Jobs Scraper", "description": "Remote jobs from Himalayas with salary as numbers, the countries candidates may live in, allowed time zones and seniority. Search by title or skill, filter by candidate country, seniority or company, and get up to 5,000 results per search.", "version": "0.1", "x-build-id": "T9mn2qgAmbktHn5zj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~himalayas-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~himalayas-jobs-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~himalayas-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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": "Search for", "type": "array", "description": "Each entry is a separate Himalayas search, exactly like typing it into the search box on the site: a job title, a skill or a company name, for example \"data engineer\" or \"product designer\". Leave empty to read the newest jobs.", "items": { "type": "string" } }, "countries": { "title": "Candidates located in", "type": "array", "description": "Keep jobs open to candidates in these countries, as a name (\"Germany\") or a two-letter code (\"DE\"). Each country is a separate search. Jobs open worldwide are included unless you turn on the next option.", "items": { "type": "string" } }, "excludeWorldwide": { "title": "Only jobs that name these countries", "type": "boolean", "description": "With countries set, drop jobs open worldwide and keep only those restricted to one of your countries.", "default": false }, "worldwideOnly": { "title": "Only jobs open worldwide", "type": "boolean", "description": "Keep only jobs that accept candidates from anywhere.", "default": false }, "seniority": { "title": "Seniority", "type": "array", "description": "Keep only these levels. Leave empty for all.", "items": { "type": "string", "enum": [ "Entry-level", "Mid-level", "Senior", "Manager", "Director", "Executive" ] } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Keep only these types. Leave empty for all.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "internship", "volunteer" ], "enumTitles": [ "Full time", "Part time", "Contractor", "Temporary", "Internship", "Volunteer" ] } }, "companies": { "title": "Companies", "type": "array", "description": "Only jobs from these employers, as the Himalayas company slug (\"gitlab\") or company page link (\"https://himalayas.app/companies/gitlab\"). Leave empty for all.", "items": { "type": "string" } }, "timezone": { "title": "Time zone", "type": "string", "description": "Keep jobs that accept candidates working in this time zone, for example UTC-5 or UTC+05:30." }, "sort": { "title": "Sort by", "enum": [ "recent", "relevant", "salaryDesc", "salaryAsc" ], "type": "string", "description": "Order in which Himalayas returns the results. Newest first suits a daily alert.", "default": "recent" }, "minSalary": { "title": "Minimum salary", "type": "integer", "description": "Drop jobs whose published top of range, counted per year (monthly pay times 12, weekly times 52, hourly times 2,080), is below this number, in the currency the board publishes. Jobs with no published salary are kept, because an absent salary is not a low one." }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 1, "type": "integer", "description": "Drop jobs older than this. Filtered jobs are never charged." }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, company, category or tags contain any of these words, for example \"senior\" or \"sales\".", "items": { "type": "string" } }, "maxJobsPerSearch": { "title": "Maximum jobs per search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap for each search (each search term in each country). Himalayas serves up to 5,000 results per search.", "default": 500 }, "includeDescription": { "title": "Include the full description", "type": "boolean", "description": "Adds the full job description as plain text. Off, each row carries the first 300 characters.", "default": false }, "newOnly": { "title": "Return only jobs new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only jobs that were not there before. Schedule it daily and you have a job alert that bills only for new postings.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"python-europe\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned jobs in the run. The run stops reading as soon as it has this many.", "default": 3000 } } }, "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 } } } } } } } } } }