# JobsDB Scraper โ€” Hong Kong & Thailand Job Listings (`blackfalcondata/jobsdb-scraper`) Actor Scrape JobsDB Hong Kong and Thailand job listings with salary parsing, employer profile enrichment, applicant-demand signals, contact extraction, incremental change tracking, notifications, and agent-ready deduped exports for recruiting and market research. - **URL**: https://apify.com/blackfalcondata/jobsdb-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 44 total users, 20 monthly users, 93.6% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does JobsDB Scraper do? JobsDB Scraper extracts structured job data from [jobsdb.com](https://hk.jobsdb.com) across Hong Kong (`hk.jobsdb.com`) and Thailand (`th.jobsdb.com`) โ€” including salary data, employer profiles, contact details, work arrangements, and enriched job descriptions. It supports keyword search, location filters, classification and salary-range filters, and controllable result limits, so you can run the same query consistently over time. The actor also offers detail enrichment (description HTML, company metadata, and screening questions) where the source provides them. ### How to use this actor - ๐Ÿ‘‰ **Register for a free Apify account** โ€” no credit card required. - ๐ŸŽ‰ Just click **[Sign up free on Apify โ†’](https://console.apify.com/sign-up?fpr=1h3gvi&fp_sid=ctarich)** and complete a quick signup. - ๐Ÿ’ฐ A free Apify account includes $5 in monthly credits โ€” enough to test this actor. - โณ Scrape during the free trial, with no commitment or upfront payment required. ### Key features - **๐ŸŒ Two-market coverage** โ€” one actor covers both JobsDB markets: Hong Kong (`hk.jobsdb.com`) and Thailand (`th.jobsdb.com`). One input shape across both markets. - **โ™ป๏ธ Incremental mode** โ€” recurring runs emit only NEW / UPDATED / REAPPEARED records by default. First run builds the baseline; later runs emit only the diff. - **๐Ÿ”” Notifications out of the box** โ€” Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook. Pair with incremental + `notifyOnlyChanges` for daily new-job alerts. - **๐Ÿ”— Paste-mode URLs** โ€” paste JobsDB search-results URLs, category pages, or single job detail URLs. Build the search in JobsDB's UI, copy, paste, run. - **๐ŸŽฏ Batch searches** โ€” pass multiple keywords or locations in one run. One dedup state across all sources, one dataset, one Actor-Start charge instead of N. - **๐Ÿ”ฌ Post-filter pipeline** โ€” narrow results after collection with `includeKeywords`, `excludeKeywords`, keyword field toggles, `customFilters`, `fromDate`, `toDate`, and `maxAgeMinutes`. - **๐Ÿ’ฐ Structured salary** โ€” parse `salaryText` into `salaryMin` / `salaryMax` / `salaryCurrency` / `salaryType` automatically. HKD for HK, THB for TH. - **โญ Job score v0** โ€” `jobScore` and `jobScoreReasons[]` summarize transparent signals: parseable salary, full detail content, and posting recency. The v0 formula may evolve. - **๐Ÿ“‹ Two-stage detail enrichment** โ€” toggle `includeDetails: true` to fetch full descriptions, employer profile fields, screening questions, apply links, and work-arrangement tags. - **๐Ÿ‘ฅ Applicant demand signals** โ€” opt in with `includeApplicantInsights` to add `applicantCount`, `applicantVolumeLabel` (e.g. "High application volume"), and `coverLetterPercentage` to each job. Spot low-competition roles and gauge hiring demand. Available on standard-apply listings; external-apply listings return `null`. - **๐Ÿข Company intelligence** โ€” when details are on, each job also carries `companyLogo`, `companyCoverImageUrl`, `companyDescription`, `companyPerks`, `companyReviewRating` / `companyReviewCount`, `companySearchUrl`, `companyIndustry` / `companySize` / `companyWebsite`, and `isVerifiedAdvertiser`. Populated for listings with a SEEK company profile; logo falls back to the ad's own branding. - **๐Ÿ“ง Email + phone extraction** โ€” `extractedEmails[]` and `extractedPhones[]` are pulled from job descriptions for outreach and enrichment workflows. - **๐Ÿ“ฆ Compact mode** โ€” AI-agent and MCP-friendly payloads with core fields, score metadata, and change metadata for LLM, ATS, and salary-benchmarking pipelines. ### What data can you extract from hk.jobsdb.com? Each result includes core listing fields (`jobId`, `seekJobId`, `title`, `canonicalUrl`, `advertiserId`, `location`, `locationCountry`, and `locationState`), detail fields when enrichment is enabled (`roleId`, `description`, `descriptionHtml`, `descriptionMarkdown`, and `descriptionLength`), contact and apply information (`phoneNumber`, `applyUrl`, and `extractedEmails`), company metadata (`company`, `companyUrl`, `companyIndustry`, `companySize`, `companyWebsite`, `companyDescription`, `companyLogo`, `companyCoverImageUrl`, `companyPerks`, `companyReviewRating`, `companyReviewCount`, `companySearchUrl`, `isVerifiedAdvertiser`), ranking fields (`jobScore`, `jobScoreReasons`), and โ€” when `includeApplicantInsights: true` โ€” applicant-demand fields (`applicantCount`, `applicantVolumeLabel`, `coverLetterPercentage`). In standard mode, all fields are always present โ€” unavailable data points are returned as `null`, never omitted. In compact mode, only core fields plus score/change metadata are returned. ### Input The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`query`** โ€” Job search keywords. For a single term: `software engineer`. For multiple terms (OR โ€” runs each as a separate search and merges results, deduplicated by job ID), use a JSON array, for example: `["ERP Implementation", "ERP Initiatives"]`. - **`country`** โ€” Which JobsDB market to search. (default: `"HK"`) - **`location`** โ€” City, state, or region. For a single location: `Hong Kong`. For multiple locations, use a JSON array, for example: `["Hong Kong", "Bangkok"]`. - **`startUrls`** โ€” Direct JobsDB search URLs. โœ… Valid shapes: `https://hk.jobsdb.com/jobs` (all jobs), `https://hk.jobsdb.com/jobs-in-information-technology` (category), `https://th.jobsdb.com/jobs` (Thailand market). โŒ The bare homepage (`https://hk.jobsdb.com`) is **not** accepted โ€” use a `/jobs` path. These are additive: if you also enter a search term, both the query and the URLs are scraped. - **`maxResults`** โ€” Maximum total job listings to return after output filters are applied (0 = unlimited). Cost control: Apify charges per emitted record, so this is your primary knob. If both maxResults and maxPages are set, the lower cap wins. (default: `25`) - **`maxPages`** โ€” Maximum SERP pages to scrape per search source. In incremental mode this defines the tracked search universe. This is a defensive safety bound โ€” use maxResults for cost control. If both maxResults and maxPages are set, the lower cap wins. (default: `5`) - **`sortMode`** โ€” Sort results by relevance or date. - **`dateRange`** โ€” Filter jobs posted within a time range (e.g. '1', '3', '7', '14', '31'). - **`workType`** โ€” Filter by work type code (e.g. '242' for Full Time on JobsDB). - **`workArrangement`** โ€” Filter by work arrangement code (e.g. '2' for Remote). - **`classification`** โ€” Filter by job classification/category code (e.g. '6281' for IT). - **`subClassification`** โ€” Filter by job sub-classification code (e.g. '6287' for Developers/Programmers under IT). - **`includeKeywords`** โ€” Comma-separated keywords that must appear in the built job record. By default this searches title, company, location, category, work type, salary text, teaser, description, and bullet points. - **`excludeKeywords`** โ€” Comma-separated keywords to exclude. By default this checks title, company, teaser, description, and bullet points. - **`fromDate`** โ€” Keep jobs posted on or after this date. Use YYYY-MM-DD or an ISO date/time. - **`toDate`** โ€” Keep jobs posted on or before this date. Same date format as fromDate. - **`maxAgeMinutes`** โ€” Keep only jobs posted within this many minutes. Records without a parseable posted date are kept. - **`customFilters`** โ€” Advanced output-field filters. Example: [{"field":"jobScore","op":"gte","value":"3"},{"field":"contentQuality","op":"equals","value":"full"}]. Operators: includes, notIncludes, equals, notEquals, gt, gte, lt, lte. - **`compact`** โ€” Output only core fields plus jobScore/change metadata for AI-agent/MCP workflows. (default: `false`) - **`incrementalMode`** โ€” Compare against previous run state and emit NEW / UPDATED / REAPPEARED jobs by default. Leave stateKey empty to auto-derive it from search and filter inputs. (default: `false`) - **`includeApplicantInsights`** โ€” Add applicant-demand fields to each job: `applicantCount` (number of applicants), `applicantVolumeLabel` (e.g. "High application volume"), and `coverLetterPercentage`. Useful for spotting low-competition roles and gauging hiring demand. Enabled by default; turn off to skip it. Coverage is partial โ€” only standard-apply listings expose this data; jobs that apply on an external site return `null` for these fields. (default: `true`) - ...and 29 more parameters ### Input examples **Basic keyword search** โ€” Find Hong Kong software jobs and enrich each result with full detail fields. โ†’ Structured job records with salary, company, description, apply URL, and contact fields where available. ```json { "query": "software engineer", "country": "HK", "location": "Hong Kong", "maxResults": 25, "includeDetails": true } ```` **Paste a JobsDB search URL** โ€” Use a JobsDB search URL directly. URLs are additive, so you can combine them with normal search inputs. โ†’ Jobs from the pasted search URL with the same output schema as keyword searches. ```json { "startUrls": [ "https://hk.jobsdb.com/software-engineer-jobs" ], "maxResults": 10, "includeDetails": true } ``` **Advanced filtered output** โ€” Enrich results, keep only matching jobs, and sort downstream by `jobScore`. โ†’ A compact filtered dataset suited for AI-agent and MCP workflows. ```json { "query": "software engineer", "country": "HK", "maxResults": 25, "salaryMin": 30000, "salaryMax": 90000, "includeKeywords": "python,typescript", "excludeKeywords": "senior", "customFilters": [ { "field": "jobScore", "op": "gte", "value": "3" }, { "field": "contentQuality", "op": "equals", "value": "full" } ], "compact": true } ``` **Recurring incremental monitoring** โ€” Track a Hong Kong search over scheduled runs and emit only new or changed jobs by default. โ†’ A deduped change feed with `changeType`, timestamps, and repost metadata. ```json { "query": "data analyst", "country": "HK", "maxResults": 100, "incrementalMode": true, "stateKey": "hk-data-analyst-monitor" } ``` ### Output Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example job record ```json { "jobId": "2b7a71af2490afabab6291a716744969d6cd615751992d35500c20c07514c0de", "seekJobId": "91615653", "title": "Software Engineer", "canonicalUrl": "https://hk.jobsdb.com/job/91615653", "company": "Process Automation International Ltd", "advertiserId": "61276721", "location": "Tai Po District", "locationCountry": "HK", "locationState": "Tai Po District", "salaryCurrency": "HKD", "employmentType": "Full time", "workArrangement": "onsite", "category": "Information & Communication Technology", "subCategory": "Engineering - Software", "roleId": "software-engineer", "teaser": "Responsibilities\n1. Perform Programming Development Duties\n2. Handle System Design ofย various application\n3. Perform System Testing, Documentation", "bulletPoints": [ "Higher Diploma or Bachelorโ€™s degree in Computer Science, IT, or related fields", "Hands-on program coding in C, VB, Java, Node.js and C#", "Knowledge of RDBMS, ideally MS SQL" ], "description": "Responsibilities\n\nPerform Programming Development Duties\n\nHandle System Design of various application\n\nPerform System Testing, Documentation\n\nRequirements:\n\nHigher Diploma or Bachelorโ€™s degree in Comp...", "descriptionHtml": "

Responsibilities