{ "openapi": "3.0.1", "info": { "title": "Himalayas Remote Jobs Scraper", "description": "Scrape remote job listings from Himalayas.app public API. Filter by keyword, seniority, employment type, country, and worldwide availability. Returns structured job data with salary, company info, and apply links. No API key required.", "version": "0.1", "x-build-id": "FDTOd3yRKFs7GoCQS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/inlifeprojects~himalayas-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-inlifeprojects-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/inlifeprojects~himalayas-jobs-scraper/runs": { "post": { "operationId": "runs-sync-inlifeprojects-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/inlifeprojects~himalayas-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-inlifeprojects-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search for. Each keyword runs a separate API search and results are deduplicated. E.g. ['react engineer', 'python developer', 'devops']", "default": [ "software engineer" ], "items": { "type": "string" } }, "seniority": { "title": "Seniority levels", "type": "array", "description": "Filter by seniority. Accepted values: Entry-level, Mid-level, Senior, Manager, Director, Executive. Leave empty for all levels.", "default": [ "Senior", "Mid-level", "Entry-level" ], "items": { "type": "string" } }, "employmentType": { "title": "Employment type", "enum": [ "Full Time", "Part Time", "Contractor", "Temporary", "Intern", "Volunteer", "Other", "" ], "type": "string", "description": "Filter by employment type.", "default": "Full Time" }, "worldwide": { "title": "Worldwide only", "type": "boolean", "description": "When true, only returns jobs explicitly open to candidates worldwide. Recommended for global talent platforms.", "default": true }, "country": { "title": "Country filter (optional)", "type": "string", "description": "Filter by country using ISO alpha-2 code, common name, or slug. E.g. 'US', 'Germany', 'spain'. Only used when 'Worldwide only' is false.", "default": "" }, "sortBy": { "title": "Sort results by", "enum": [ "recent", "relevant", "salaryAsc", "salaryDesc", "nameAToZ", "nameZToA" ], "type": "string", "description": "Sort order for results returned by the Himalayas API.", "default": "recent" }, "maxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of jobs to collect per keyword. Himalayas returns max 20 per page. Set lower for faster runs.", "default": 100 }, "filterNonTech": { "title": "Filter out non-tech roles", "type": "boolean", "description": "When true, removes clearly non-technical roles such as receptionist, accountant, driver, nurse etc. from results.", "default": false }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "If provided, POSTs all results to this URL in batches of 50 when the Actor completes. Ideal for job boards and data pipelines.", "default": "" }, "webhookSecret": { "title": "Webhook secret (optional)", "type": "string", "description": "If provided alongside webhookUrl, sent as X-Scraper-Secret header to authenticate webhook delivery." } } }, "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 } } } } } } } } } }