# JobsDB Jobs Scraper (`robertosan16/jobsdb-jobs-scraper`) Actor

Scrape JobsDB jobs in Hong Kong and Thailand by keyword and location: title, company, salary as numbers, work type, classification, full description and apply link. Filters and alerts.

- **URL**: https://apify.com/robertosan16/jobsdb-jobs-scraper.md
- **Developed by:** [Robert Khairislamov](https://apify.com/robertosan16) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.50 / 1,000 jobs

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

## JobsDB Jobs Scraper

**Scrape JobsDB jobs in Hong Kong and Thailand by keyword and location.** Get title, company, salary as numbers, work type, classification, full description, expiry date and apply link. Export to JSON, CSV or Excel, or use the API. **$0.50 per 1,000 jobs, no start fee.**

Scrape jobs from **JobsDB** (`hk.jobsdb.com`, `th.jobsdb.com`), the way you search on the website: keywords, location and every JobsDB filter. Each job comes with the **salary as numbers** in HKD or THB (for example "$20,000 – $30,000 per month"), work type, work arrangement, classification, district, the full description, the expiry date and the company's industry, size and website. JobsDB shows at most 550 jobs per search; this scraper splits big searches to **get them all**. Run it on a schedule to get **only new jobs**. No browser, no login.

### What can this JobsDB scraper do?

- 🔎 **Search like on the website**: keywords such as `accountant` or `software engineer`, a district or city, or paste any JobsDB search link.
- 🌏 **Hong Kong and Thailand**: pick the country; salaries come in HKD or THB.
- 🎛️ **All JobsDB filters**: classification, work type (full time, part time, contract/temp, casual), work arrangement (on-site, hybrid, remote), date listed and minimum salary per month, year or hour. Sort by newest or by relevance.
- ♾️ **Beyond 550 results**: big searches are split by classification, work type and salary band, then merged without duplicates.
- 💰 **Salary as numbers**: "$20,000 – $30,000 per month" becomes `{ "min": 20000, "max": 30000, "currency": "HKD", "interval": "month" }`. Labels such as "30k-35k/month", "$400k - $500k p.a." or "฿24,000 per month" are understood too.
- 🏢 **Company profile**: industry, number of employees, website and the company's rating on the site.
- 🆕 **Only new jobs since the last run**: for job alerts, recruiting pipelines and market monitoring.
- 🧩 **Same output as our other job scrapers**, listed at the end of this page, so jobs from company career sites and job boards fit into one table.

### What data does it extract?

| Field | Example |
|---|---|
| `title` | Corporate Services Manager |
| `companyName` | Urban Coffee Roaster |
| `department` / `subClassification` | Accounting / Financial Managers & Controllers |
| `location` / `suburb` / `state` | Tai Kok Tsui, Yau Tsim Mong District / Tai Kok Tsui / Yau Tsim Mong District |
| `workplaceType` / `employmentType` | onsite / full-time |
| `salary` | `{ "min": 25000, "max": 25000, "currency": "HKD", "interval": "month" }` |
| `postedAt` / `validThrough` | 2026-09-16 / 2026-10-16 |
| `companyIndustry` / `companySize` | Drinks Retail / 11-50 employees |
| `jobUrl` / `applyUrl` | https://hk.jobsdb.com/job/94677274 |
| `descriptionText` / `descriptionHtml` | full job description |

### How to scrape JobsDB jobs

1. Enter **job titles or keywords**, one search per line, for example `accountant`. Or paste links of searches you made on JobsDB.
2. Pick the **country** and optionally a **location** such as `Kowloon`, `Hong Kong Island` or `Bangkok`.
3. Optionally choose **classifications**, **work types**, **work arrangements**, a **minimum salary** or a **date range**.
4. Click **Start**. Download the jobs as JSON, CSV, Excel or HTML, or get them through the API.

#### Example input

```json
{
  "searchQueries": ["accountant", "marketing manager"],
  "country": "HK",
  "location": "Kowloon",
  "workTypes": ["242"],
  "postedWithinDays": 7,
  "onlyWithSalary": true
}
```

Work types are `242` full time, `243` part time, `244` contract/temp and `245` casual/vacation. In the form you simply pick them from a list.

#### Example output

```json
{
  "ats": "jobsdb",
  "company": "60179574",
  "companyName": "Urban Coffee Roaster",
  "jobId": "94677274",
  "title": "Corporate Services Manager",
  "department": "Accounting",
  "location": "Tai Kok Tsui, Yau Tsim Mong District",
  "locations": ["Tai Kok Tsui, Yau Tsim Mong District"],
  "remote": false,
  "workplaceType": "onsite",
  "employmentType": "full-time",
  "salary": { "min": 25000, "max": 25000, "currency": "HKD", "interval": "month", "text": "$25,000 per month", "source": "listing" },
  "postedAt": "2026-09-16T11:25:42.311Z",
  "jobUrl": "https://hk.jobsdb.com/job/94677274",
  "applyUrl": "https://hk.jobsdb.com/job/94677274/apply",
  "descriptionText": "About the Company\n\nWe are a rapidly growing F&B brand operating a network of popular cafes and specialty restaurants…",
  "descriptionHtml": "<p>About the Company</p>…",
  "subClassification": "Financial Managers & Controllers",
  "suburb": "Tai Kok Tsui",
  "state": "Yau Tsim Mong District",
  "country": "Hong Kong SAR",
  "validThrough": "2026-10-16T12:59:59.999Z",
  "companyIndustry": "Drinks Retail",
  "companySize": "11-50 employees",
  "companyLogoUrl": "https://bx-branding-gateway.cloud.seek.com.au/….1/jdpLogo",
  "scrapedAt": "2026-09-26T10:50:30.934Z"
}
```

### Use cases

- **Recruitment agencies and headhunters**: see every new role in Hong Kong or Thailand each morning, with pay and company size.
- **Job boards and aggregators**: fill a Hong Kong or Thai job board with fresh JobsDB listings.
- **Sales and lead generation**: companies hiring are growing. Industry, size and website turn job ads into leads.
- **Salary research**: compare monthly pay by role, classification, district and work type.
- **Labor market analytics**: track demand by classification and location over time.

### How much does it cost?

You pay only for the jobs you get: **$0.50 per 1,000 jobs**. There is no start fee. Jobs filtered out by your settings are free. The Apify free plan covers about 10,000 jobs every month.

### Tips

- **Daily job alerts**: save your input as a task, turn on **Only new jobs since the last run** and add a schedule. Send new jobs to Slack, email or Google Sheets with Apify integrations.
- **Fast lists**: turn off **Load full job details**. You still get title, company, location, salary, work type and date.
- **Stricter results**: JobsDB also matches related words. Use **Title must contain** to keep only jobs with your keyword in the title.
- **Errors per search**: see the `SUMMARY` record in the run's key-value store.

### FAQ

**Why do some jobs have no salary?** Many ads show text such as "Competitive" instead of numbers. When numbers are given, they are parsed; `salary.text` keeps the original wording.

**Does it collect recruiter contact details?** No. There are no fields for recruiters' names, emails or phone numbers, and they are not requested. The job description is saved as the employer wrote it.

**Is it legal to scrape JobsDB?** The Actor reads the public job listings JobsDB shows to every visitor. Check the terms that apply to your use case.

### Integrations and API

- **Google Sheets, Slack, email and CRMs**: connect the Actor to Make, Zapier or n8n, or use the **Integrations** tab of this Actor. With **Only new jobs since the last run** and a schedule, each run sends only the new jobs.
- **Webhooks**: call your own URL when a run finishes, for example to load the new jobs into your database.
- **AI agents (MCP)**: add `https://mcp.apify.com?tools=robertosan16/jobsdb-jobs-scraper` as an MCP server in Claude, Cursor or VS Code, and your agent can search jobs with this Actor. Tell it how many jobs you need, so it sets **Maximum jobs in total**.
- **LangChain and LlamaIndex**: load the jobs into your LLM app with the Apify loaders.
- **API**: one request runs the Actor and returns the jobs, for runs of up to 5 minutes. Start longer runs with the `runs` endpoint and read the dataset when they finish.

```bash
curl -X POST "https://api.apify.com/v2/acts/robertosan16~jobsdb-jobs-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["accountant"],"country":"HK","maxItems":20}'
```

### More job scrapers with the same output

- [Greenhouse Jobs Scraper](https://apify.com/robertosan16/greenhouse-jobs-scraper): every job of any company on Greenhouse, with salary ranges
- [Lever Jobs Scraper](https://apify.com/robertosan16/lever-jobs-scraper): every job of any company on Lever, including EU sites
- [Ashby Jobs Scraper](https://apify.com/robertosan16/ashby-jobs-scraper): startup jobs from Ashby job boards, with compensation
- [Workday Jobs Scraper](https://apify.com/robertosan16/workday-jobs-scraper): every job from any Workday career site, past the 2,000 search limit
- [Dice Jobs Scraper](https://apify.com/robertosan16/dice-jobs-scraper): US tech jobs from Dice.com, with skills and salaries
- [Welcome to the Jungle Jobs Scraper](https://apify.com/robertosan16/welcome-to-the-jungle-jobs-scraper): startup jobs in France, Europe, the UK and the US
- [SEEK Jobs Scraper](https://apify.com/robertosan16/seek-jobs-scraper): jobs in Australia and New Zealand, with salaries as numbers
- [StepStone Jobs Scraper](https://apify.com/robertosan16/stepstone-jobs-scraper): jobs in Germany, with benefits and English-language jobs
- [Jobstreet Jobs Scraper](https://apify.com/robertosan16/jobstreet-jobs-scraper): jobs in Malaysia, Singapore, the Philippines and Indonesia, with salaries as numbers
- [Reed Jobs Scraper](https://apify.com/robertosan16/reed-jobs-scraper): UK jobs from Reed.co.uk, with salaries, contract type and hybrid or remote
- [InfoJobs Jobs Scraper](https://apify.com/robertosan16/infojobs-jobs-scraper): jobs in Spain from InfoJobs.net, with salaries and remote policy
- [LinkedIn Jobs Scraper](https://apify.com/robertosan16/linkedin-jobs-scraper): public LinkedIn job listings without login, with full job details
- [All-in-One Jobs Scraper](https://apify.com/robertosan16/all-in-one-jobs-scraper): LinkedIn and all of these job sites and career sites in one search, without duplicates

Missing a field or a feature? Open an issue in the Issues tab and we will reply quickly.

# Actor input Schema

## `searchQueries` (type: `array`):

What to search, for example <code>software engineer</code> or <code>accountant</code>. Each line is a separate search with the filters below. You can also paste links of searches from hk.jobsdb.com or th.jobsdb.com.

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

The JobsDB site to search. Salaries come in its currency, HKD or THB.

## `location` (type: `string`):

A suburb, city, region or state as on JobsDB, for example <code>Kowloon</code>, <code>Hong Kong Island</code> or <code>Bangkok</code>. Leave empty for the whole country.

## `classifications` (type: `array`):

Job categories as on SEEK. Leave empty for all.

## `workTypes` (type: `array`):

Leave empty for all.

## `workArrangements` (type: `array`):

On-site, hybrid or remote. Leave empty for all.

## `postedWithinDays` (type: `integer`):

Keep jobs listed in the last N days: 1 means today and yesterday. Leave empty or 0 for any date.

## `minSalary` (type: `integer`):

Keep jobs paying at least this much, in HKD or THB, per the salary type below. JobsDB applies it to the pay range the employer set, even when the ad does not show it.

## `salaryType` (type: `string`):

What the minimum salary above means.

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

Newest first suits job alerts. Links you paste keep their own order.

## `excludeKeywords` (type: `array`):

Skip jobs whose title contains any of these, for example <code>intern</code> or <code>senior</code>. Common word endings are included.

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

Keep only jobs whose title contains any of these words or phrases. JobsDB searches descriptions too, so this makes results stricter. Add <code>*</code> for any ending: <code>data*</code>.

## `onlyWithSalary` (type: `boolean`):

Keep only jobs that state a pay range or rate.

## `onlyNew` (type: `boolean`):

For scheduled runs: save only jobs that were not seen in earlier runs of the same saved task. The first run saves all current jobs and remembers them. Jobs that did not match your filters are remembered too.

## `includeDescription` (type: `boolean`):

Open each job page for the full description (text and HTML), expiry date and company industry, size and website. Turn off for fast results with a short summary instead.

## `maxItems` (type: `integer`):

Stop after saving this many jobs. Leave empty or 0 for no limit. The example is kept small so the first run takes seconds.

## `maxItemsPerCompany` (type: `integer`):

Save at most this many jobs from each search. Leave empty or 0 for no limit.

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

The Actor connects directly, which is fastest. If JobsDB starts limiting requests, it switches to Apify Proxy automatically. Turn on a proxy here only to use it from the start.

## Actor input object example

```json
{
  "searchQueries": [
    "software engineer"
  ],
  "country": "HK",
  "salaryType": "monthly",
  "sortBy": "ListedDate",
  "onlyWithSalary": false,
  "onlyNew": false,
  "includeDescription": true,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `jobs` (type: `string`):

Job postings with title, company, locations, salary, dates, description and links.

## `summary` (type: `string`):

Jobs found, matched and saved for each company, with errors.

# 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 = {
    "searchQueries": [
        "software engineer"
    ],
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("robertosan16/jobsdb-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 = {
    "searchQueries": ["software engineer"],
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("robertosan16/jobsdb-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 '{
  "searchQueries": [
    "software engineer"
  ],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call robertosan16/jobsdb-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,robertosan16/jobsdb-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/0J65gxORk1dXaR80v/builds/rHp4Bc8LrOGFsQtZ4/openapi.json
