{ "openapi": "3.0.1", "info": { "title": "Himalayas Remote Jobs Scraper (Worldwide)", "description": "Scrape 100,000+ worldwide remote job listings from Himalayas with real numeric salary, seniority, location and timezone restrictions, and incremental mode.", "version": "1.0", "x-build-id": "Gvs8T3XlnHn4q1xkp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axery~himalayas-remote-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axery-himalayas-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/axery~himalayas-remote-jobs-scraper/runs": { "post": { "operationId": "runs-sync-axery-himalayas-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/axery~himalayas-remote-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-axery-himalayas-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": { "queries": { "title": "Search keywords", "type": "array", "description": "Keywords matched against job title, company, excerpt and category tags. Leave empty to stream the newest listings, which is the usual choice for monitoring. Filtering is applied as pages stream in, so a narrow keyword reads more pages to fill your limit.", "items": { "type": "string" } }, "categories": { "title": "Category tags (optional)", "type": "array", "description": "Restrict to listings carrying any of these Himalayas category tags, e.g. `Software-Engineering`, `Product-Design`, `Customer-Support`. Tags appear in each row's `categories` field, so run once without a filter to discover the ones you want.", "items": { "type": "string" } }, "seniority": { "title": "Seniority (optional)", "type": "array", "description": "Restrict by experience level. Values the board uses include `Entry-level`, `Mid-level`, `Senior`, `Manager`, `Director`, `Executive`.", "items": { "type": "string" } }, "salaryMin": { "title": "Minimum salary (optional)", "minimum": 0, "type": "integer", "description": "Keep only listings whose advertised maximum is at least this figure. Careful: currencies and periods differ between listings (USD per year and GBP per hour both occur), so this compares raw numbers, not converted ones. Listings with no disclosed salary are excluded when this is set." }, "maxItems": { "title": "Max jobs per query", "minimum": 0, "type": "integer", "description": "Maximum listings to return per keyword. Set to `0` for unlimited, which pages through the whole feed — currently over 100,000 listings, so set a limit unless you mean it.", "default": 100 }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Include the full job description as both plain text and HTML. Turn off for a much smaller dataset when you only need titles, companies and salaries.", "default": true }, "incremental": { "title": "Incremental mode (only new jobs)", "type": "boolean", "description": "Remember job ids between runs and return only listings not seen before. You are charged only for the new rows, so a daily monitor costs a fraction of a full re-scrape after the first run. Ids are stored in this Actor's key-value store under `seen_job_ids`.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Defaults to Residential - Apify's own Datacenter proxy range gets blocked by this feed intermittently (this Actor was flagged by Apify's automated QA after failing from a Datacenter IP), even though a direct residential-ISP connection succeeds every time.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } }, "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 } } } } } } } } } }