{ "openapi": "3.0.1", "info": { "title": "Himalayas Scraper - Remote Jobs, Salaries & Company Profiles", "description": "Scrape Himalayas remote jobs and company profiles: title, salary, seniority, countries, timezones, skills and apply link, plus company website, size, founded year, CEO, markets, tech stack, benefits and socials. Every Himalayas filter, past the 5,000-job window, companies hiring for a search.", "version": "0.1", "x-build-id": "hL6ONAIIA6GmLmoQB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~himalayas-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-himalayas-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/scrapersdelight~himalayas-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-himalayas-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/scrapersdelight~himalayas-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-himalayas-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": { "mode": { "title": "What to scrape", "enum": [ "jobs", "companies", "hiringCompanies" ], "type": "string", "description": "Remote jobs (one row per job), company profiles (one row per company, with size, founded year, CEO, website, socials, tech stack and benefits), or companies hiring for your job search (one row per hiring company with its matching jobs).", "default": "jobs" }, "searchQueries": { "title": "Keywords", "type": "array", "description": "One search per keyword, e.g. \"react engineer\", \"customer success\", \"data analyst\". In company mode the keyword searches company names and descriptions, e.g. \"fintech\". Empty = no keyword.", "items": { "type": "string" } }, "jobUrls": { "title": "Job URLs", "type": "array", "description": "Himalayas job pages to fetch one by one, e.g. https://himalayas.app/companies/stripe/jobs/product-designer-terminal. Jobs mode only; a closed job is listed as not found and not charged.", "items": { "type": "string" } }, "companySlugs": { "title": "Companies", "type": "array", "description": "Himalayas company slugs or company URLs, e.g. \"stripe\", \"gitlab\", https://himalayas.app/companies/doist. Jobs modes: only these companies' jobs. Company mode: these profiles.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Jobs open to candidates in these countries (one search per country). ISO code or name, e.g. \"US\", \"Germany\", \"UK\". Company mode: companies located there.", "items": { "type": "string" } }, "worldwideOnly": { "title": "Worldwide jobs only", "type": "boolean", "description": "Only jobs open to candidates anywhere in the world (no country restriction).", "default": false }, "excludeWorldwide": { "title": "Exclude worldwide jobs", "type": "boolean", "description": "With a country set: only jobs that name that country, leaving out jobs open worldwide.", "default": false }, "seniority": { "title": "Seniority", "type": "array", "description": "Any of these levels. Empty = all levels.", "items": { "type": "string", "enum": [ "Entry-level", "Mid-level", "Senior", "Manager", "Director", "Executive" ], "enumTitles": [ "Entry-level (0-2 years)", "Mid-level (2-5 years)", "Senior (5+ years)", "Manager", "Director", "Executive (C-suite, VP)" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Any of these types. Empty = all types.", "items": { "type": "string", "enum": [ "Full Time", "Part Time", "Contractor", "Temporary", "Intern", "Volunteer", "Other" ], "enumTitles": [ "Full time", "Part time", "Contractor / freelance", "Temporary", "Internship", "Volunteer", "Other" ] } }, "timezone": { "title": "Timezone", "type": "string", "description": "Jobs whose working hours fit this UTC offset, e.g. \"-5\", \"UTC+1\", \"UTC+05:30\". Empty = any timezone." }, "sort": { "title": "Sort jobs by", "enum": [ "relevant", "recent", "salaryDesc", "salaryAsc" ], "type": "string", "description": "Order Himalayas returns jobs in. \"Newest first\" pairs with \"Posted within\" for daily alerts.", "default": "relevant" }, "benefits": { "title": "Company benefits", "type": "array", "description": "Company mode: companies that offer all of these benefits.", "items": { "type": "string", "enum": [ "Healthcare benefits", "Retirement benefits", "Paid parental leave", "Equity benefits", "Location independent salary", "Profit sharing", "4-day workweeks", "Generous vacation", "Paid vacation", "Sabbaticals", "Unlimited time off", "Company meals", "Wellness benefits", "Home office budget", "Co-working space budget", "Commuter benefits", "Pet-friendly office", "Learning and development budget", "Company events", "Volunteer opportunities", "Open source", "Company credit card", "Life insurance", "Employee assistance program (EAP)", "Flexible working hours", "Disability insurance", "Fertility benefits", "Company retreats", "Get paid in crypto", "Miscellaneous" ] } }, "techStack": { "title": "Company tech stack", "type": "array", "description": "Company mode: companies that use all of these technologies, e.g. \"react\", \"python\", \"kubernetes\", \"ruby-on-rails\".", "items": { "type": "string" } }, "companySort": { "title": "Sort companies by", "enum": [ "relevant", "recent", "jobs", "nameAToZ", "nameZToA" ], "type": "string", "description": "Company mode: order of the company directory or company search.", "default": "relevant" }, "categories": { "title": "Job categories", "type": "array", "description": "Keep jobs in any of these Himalayas categories, e.g. \"Software Engineer\", \"Customer Success\", \"Developer\", \"Marketing\".", "items": { "type": "string" } }, "includeKeywords": { "title": "Must contain", "type": "array", "description": "Keep jobs whose title or description contains any of these words, e.g. \"typescript\", \"visa sponsorship\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Drop jobs whose title or description contains any of these words, e.g. \"senior\", \"clearance\".", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Drop jobs from companies whose name or slug contains any of these, e.g. \"mercor\", \"lemon\".", "items": { "type": "string" } }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only jobs that publish a salary range.", "default": false }, "minAnnualSalary": { "title": "Minimum yearly salary", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Keep jobs whose yearly salary (hourly x 2,080, monthly x 12) reaches this, in the currency below, e.g. 100000. Jobs in another currency are left out. 0 = off.", "default": 0 }, "salaryCurrency": { "title": "Salary currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "NZD", "CHF", "SEK", "NOK", "DKK", "PLN", "INR", "SGD", "JPY", "BRL", "MXN", "ZAR" ], "type": "string", "description": "Currency of the minimum yearly salary.", "default": "USD" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Keep jobs posted in the last N days, e.g. 1 for a daily run. 0 = any date. With newest-first order the walk stops at the first older page.", "default": 0 }, "includeJobDetails": { "title": "Skills, education & experience", "type": "boolean", "description": "Add each job's skills list, education requirement and minimum years of experience (one extra request per job, no extra charge).", "default": false }, "includeCompanyProfile": { "title": "Company profile on each job", "type": "boolean", "description": "Jobs mode: add the hiring company's website, size, founded year, CEO, locations, markets, tech stack, benefits and socials to each job. Charged once per company per run as a company profile.", "default": false }, "includeOpenJobs": { "title": "Open jobs on company rows", "type": "boolean", "description": "Company modes: add the company's open jobs, hiring countries, timezones, seniority mix and USD salary range.", "default": false }, "maxOpenJobsPerCompany": { "title": "Open jobs per company", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many open jobs to read per company when \"Open jobs on company rows\" is on (20 per request).", "default": 20 }, "maxMatchedJobsPerCompany": { "title": "Matching jobs per company", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hiring-companies mode: how many of a company's matching jobs to list on its row.", "default": 20 }, "onlyNew": { "title": "Only new rows", "type": "boolean", "description": "Skip jobs (or companies) that an earlier run with the same input already delivered. Pairs with a daily schedule.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that remembers delivered rows between runs. Use a different name to keep separate alert histories." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Most rows to deliver in this run (jobs, or companies in company modes). A single search stops at 5,000 jobs; turn on deep search to go past it.", "default": 100 }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Cap per keyword x country search. 0 = no per-search cap.", "default": 0 }, "deepSearch": { "title": "Deep search (past 5,000)", "type": "boolean", "description": "When a search finds more than 5,000 jobs, re-run it split by seniority and employment type (each slice has its own 5,000 window) and remove duplicates.", "default": false }, "descriptionFormat": { "title": "Job description", "enum": [ "text", "html", "both", "none" ], "type": "string", "description": "Full job description as plain text, HTML, both, or left out for smaller rows.", "default": "text" }, "descriptionMaxLength": { "title": "Description max length", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cut descriptions to this many characters. 0 = full description.", "default": 0 }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Core fields only - trimmed for spreadsheets and AI / MCP pipelines.", "default": false }, "himalayasApiKey": { "title": "Himalayas API key", "type": "string", "description": "Optional free key from himalayas.app/api for your own allowance (60 requests/min, 10,000/day). Without it the jobs API's shared public allowance is used." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: requests go direct, with a budgeted residential fallback. Add your own proxy only if your network blocks himalayas.app.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }