# Himalayas Jobs Scraper (`powerbox/himalayas-jobs-scraper`) Actor

Scrape remote job listings from Himalayas.app — titles, companies, salaries, tags, descriptions, and apply links via the public jobs API.

- **URL**: https://apify.com/powerbox/himalayas-jobs-scraper.md
- **Developed by:** [PowerBox](https://apify.com/powerbox) (community)
- **Categories:** Agents
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Himalayas Jobs Scraper

Pull remote job listings from **Himalayas.app** into a clean Apify Dataset. Uses the platform’s **public JSON jobs API** (no login, no API key). Search by keyword, filter by seniority / employment type / country / category, optionally fetch specific job URLs, and export JSON / CSV / Excel or call via API / schedules / Make / Zapier / n8n.

### Features

- **Keyword search** — multi-keyword runs with automatic deduplication
- **Filters** — seniority, employment type, worldwide vs country, category substring match
- **Job URLs** — resolve individual listings through the public detail endpoint
- **Full description** — HTML description is included in search/browse results (no extra page fetch)
- **Optional webhook** — POST results in batches of 50 when the run finishes
- **Lightweight** — HTTP JSON only; proxy optional

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `keywords` | `string[]` | `["software engineer"]` | Search queries; each runs separately and results are merged |
| `jobUrls` | `string[]` | — | Himalayas job page URLs (`/companies/{slug}/jobs/{slug}`) |
| `categories` | `string[]` | — | Keep jobs whose category / parent category contains any term |
| `seniority` | `string[]` | Senior / Mid / Entry | `Entry-level`, `Mid-level`, `Senior`, `Manager`, `Director`, `Executive` |
| `employmentType` | `string` | `Full Time` | Or `Any` / Part Time / Contractor / Temporary / Intern / Volunteer / Other |
| `worldwide` | `boolean` | `true` | Only jobs with no country restrictions |
| `country` | `string` | — | ISO / name / slug when `worldwide` is false |
| `sortBy` | `string` | `recent` | `recent`, `relevant`, `salaryAsc`, `salaryDesc`, `nameAToZ`, `nameZToA` |
| `maxResultsPerKeyword` | `integer` | `100` | Cap per keyword (or browse feed), 1–500 |
| `filterNonTech` | `boolean` | `false` | Drop clearly non-technical roles |
| `webhookUrl` / `webhookSecret` | `string` | — | Optional batch delivery |

### Output

Each Dataset item includes fields such as:

| Field | Description |
| --- | --- |
| `title` | Job title |
| `company_name` / `company_slug` / `company_url` / `company_logo_url` | Company metadata |
| `location` / `location_restrictions` | Worldwide label or country list |
| `salary_min` / `salary_max` / `currency` / `salary_period` | Structured salary when published |
| `tags` / `markets` / `parent_categories` | Skill / category tags |
| `description` | Full HTML description |
| `apply_url` / `source_url` | Apply link and canonical listing URL |
| `employment_type` / `experience_level` / `posted_at` / `expires_at` | Type, seniority, timestamps |

Example:

```json
{
  "id": "senior-backend-engineer-at-acme-corp",
  "title": "Senior Backend Engineer",
  "company_name": "Acme Corp",
  "location": "Worldwide",
  "salary_min": 120000,
  "salary_max": 160000,
  "currency": "USD",
  "salary_period": "annual",
  "tags": ["Software Engineering", "Backend"],
  "apply_url": "https://himalayas.app/companies/acme-corp/jobs/senior-backend-engineer?utm_source=api",
  "source_url": "https://himalayas.app/companies/acme-corp/jobs/senior-backend-engineer",
  "work_mode": "remote",
  "data_source": "Himalayas"
}
```

### Tips

- Prefer specific titles (`react engineer`) over broad terms (`frontend`)
- Use multiple keywords — overlaps are deduplicated by listing GUID
- API pages return up to 20 jobs; 100 results ≈ 5 requests per keyword
- Attribute Himalayas and link back to `source_url` when displaying results

### Limitations

- Max 500 results per keyword per run
- Public rate limits apply; the Actor retries on HTTP 429
- Listings reflect the public remote-jobs feed only

# Actor input Schema

## `keywords` (type: `array`):

Keywords to search (e.g. react engineer, python developer). Each keyword runs a separate search; results are deduplicated. Leave empty to browse the feed (or only use Job URLs).

## `jobUrls` (type: `array`):

Optional Himalayas job page URLs (…/companies/{slug}/jobs/{job-slug}). Fetched via the public job detail API.

## `categories` (type: `array`):

Keep jobs whose category or parent category contains any of these strings (case-insensitive), e.g. Engineering, Design, Marketing.

## `seniority` (type: `array`):

Filter by seniority. Accepted values: Entry-level, Mid-level, Senior, Manager, Director, Executive. Leave empty for all levels.

## `employmentType` (type: `string`):

Filter by employment type. Choose Any for no filter.

## `worldwide` (type: `boolean`):

When enabled, only return jobs open to candidates worldwide (no country restrictions).

## `country` (type: `string`):

Country filter (ISO alpha-2, name, or slug, e.g. US, Germany, spain). Used when Worldwide only is off.

## `sortBy` (type: `string`):

Sort order for keyword search results.

## `maxResultsPerKeyword` (type: `integer`):

Maximum jobs to collect per keyword (or for the browse feed when keywords are empty). Range 1–500. API returns up to 20 jobs per page.

## `filterNonTech` (type: `boolean`):

When enabled, drop clearly non-technical roles (e.g. receptionist, accountant, driver, nurse).

## `webhookUrl` (type: `string`):

Optional URL that receives POST batches of 50 results when the run finishes.

## `webhookSecret` (type: `string`):

If set with Webhook URL, sent as the X-Scraper-Secret request header.

## `proxyConfiguration` (type: `object`):

Optional Apify Proxy. Public API usually works without a proxy; enable if you hit rate limits.

## Actor input object example

```json
{
  "keywords": [
    "software engineer"
  ],
  "seniority": [
    "Senior",
    "Mid-level",
    "Entry-level"
  ],
  "employmentType": "Full Time",
  "worldwide": true,
  "sortBy": "recent",
  "maxResultsPerKeyword": 100,
  "filterNonTech": false
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "software engineer"
    ],
    "seniority": [
        "Senior",
        "Mid-level",
        "Entry-level"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("powerbox/himalayas-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["software engineer"],
    "seniority": [
        "Senior",
        "Mid-level",
        "Entry-level",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("powerbox/himalayas-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "software engineer"
  ],
  "seniority": [
    "Senior",
    "Mid-level",
    "Entry-level"
  ]
}' |
apify call powerbox/himalayas-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,powerbox/himalayas-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UpT9JFanZF3OO9b7L/builds/WoYn4p2jjbyMUVTyU/openapi.json