# Jobsdb Scraper (`shahidirfan/jobsdb-scraper`) Actor A lightweight actor to scrape job listings from Jobsdb, extracting details like title, company, and location. It's fast and easy to use. For the most reliable and consistent results, using residential proxies is strongly recommended to prevent getting blocked and ensure data accuracy. - **URL**: https://apify.com/shahidirfan/jobsdb-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 71 total users, 17 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 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/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 ## JobsDB Scraper Extract structured job listings from JobsDB across Thailand and Hong Kong. Collect rich hiring data including company metadata, classifications, locations, work arrangements, and posting details at scale. Built for recruitment research, market monitoring, and talent intelligence workflows. ### Features - **Keyword Search** — Discover jobs by role-specific terms such as software engineer, sales manager, or accountant. - **Region Targeting** — Collect data from Thailand (`TH-Main`) and Hong Kong (`HK-Main`) markets. - **Structured Job Data** — Get normalized records ready for analytics, BI tools, and automations. - **Pagination Support** — Crawl multiple pages with controlled result limits. - **Rich Company Context** — Capture employer metadata, classifications, and listing attributes. - **Export Ready** — Use dataset output in JSON, CSV, Excel, XML, and integrations. ### Use Cases #### Recruitment Intelligence Track job demand by role, location, and industry. Compare hiring trends across markets and identify where demand is growing fastest. #### Salary and Role Benchmarking Analyze salary labels, work types, and role patterns to benchmark compensation and position strategy for hiring teams. #### Competitive Monitoring Follow competitor hiring behavior by company name, role type, and posting cadence to support workforce and growth planning. #### Talent Market Research Build searchable datasets for labor-market studies, dashboards, and forecasts across specific regions and categories. #### Lead Generation Workflows Extract employer and listing signals that can support B2B outreach, partnerships, and recruiting pipeline prioritization. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |---|---|---|---|---| | `startUrl` | String | No | — | Direct JobsDB search URL. When provided, it can override keyword/location setup. | | `keyword` | String | No | `developer` | Search keyword for job discovery. | | `location` | String | No | — | Region or city filter for matching jobs. | | `country` | String | No | `th` | Country site selector: `th` (Thailand) or `hk` (Hong Kong). | | `posted_date` | String | No | `anytime` | Posting time window: `anytime`, `24h`, `7d`, `30d`. | | `results_wanted` | Integer | No | `20` | Preferred maximum number of jobs to collect. | | `maxJobs` | Integer | No | `20` | Maximum number of jobs to collect (compatible alias). | | `maxPagesPerList` | Integer | No | `50` | Safety cap for pages to process. | | `collectDetails` | Boolean | No | `true` | Compatibility toggle retained for existing workflows. | | `proxyConfiguration` | Object | No | — | Proxy settings for improved reliability on larger runs. | --- ### Output Data Each dataset item includes: | Field | Type | Description | |---|---|---| | `id` | String | JobsDB listing identifier. | | `url` | String | Job ad URL. | | `title` | String | Job title. | | `company` | String | Employer display name. | | `location` | String | Primary location label. | | `workType` | String | Primary work type (for example Full time). | | `classification` | String | Main job classification description. | | `salary` | String | Salary label when available. | | `postedAt_relative` | String | Relative posting age (for example `3d ago`). | | `postedAt_iso` | String | ISO posting datetime when available. | | `description_text` | String | Listing teaser/summary text. | | `description_html` | String | Reserved field for compatibility. | | `source` | String | Source identifier (`jobsdb`). | | `list_url` | String | Search URL used for that item batch. | | `scrapedAt` | String | ISO extraction timestamp. | | `advertiser` | Object | Advertiser metadata (`id`, `description`). | | `branding` | Object | Branding assets such as logo URL. | | `bulletPoints` | Array | Highlight points shown in listing cards. | | `classifications` | Array | Classification and subclassification objects. | | `companyProfileStructuredDataId` | Number | Company profile structured identifier. | | `displayStyle` | Object | Listing style metadata. | | `displayType` | String | Listing type (for example `standard`, `promoted`). | | `employer` | Object | Employer metadata (`id`, `name`, company references). | | `isFeatured` | Boolean | Featured flag for listing prominence. | | `listingDate` | String | Raw listing datetime. | | `listingDateDisplay` | String | Human-readable listing age. | | `locations` | Array | Full locations array with hierarchy and country code. | | `roleId` | String | Role identifier slug. | | `solMetadata` | Object | Ranking and placement metadata for the result. | | `tags` | Array | Listing tags like urgency or expiring soon. | | `teaser` | String | Short listing summary. | | `tracking` | String | Tracking token from listing data. | | `workTypes` | Array | Work type list from source. | | `workArrangements` | Object | Work arrangement data (for example on-site, hybrid). | --- ### Usage Examples #### Basic Keyword Search ```json { "keyword": "software engineer", "country": "hk", "results_wanted": 20 } ```` #### Thailand Search by Keyword and Location ```json { "keyword": "data analyst", "location": "Bangkok", "country": "th", "posted_date": "7d", "maxJobs": 40, "maxPagesPerList": 5 } ``` #### Start from a Direct Search URL ```json { "startUrl": "https://hk.jobsdb.com/jobs?siteKey=HK-Main&keywords=project%20manager&page=1&pageSize=20", "results_wanted": 30 } ``` #### Proxy Configuration ```json { "keyword": "marketing", "country": "hk", "results_wanted": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Sample Output ```json { "id": "90538991", "url": "https://hk.jobsdb.com/job/90538991", "title": "Software Engineer", "company": "OpenRice", "location": "Quarry Bay, Eastern District", "workType": "Full time", "classification": "Information & Communication Technology", "salary": "", "postedAt_relative": "3d ago", "postedAt_iso": "2026-02-24T11:03:36.000Z", "description_text": "OpenRice is seeking an energetic and passionate talent to be part of the dynamic team.", "description_html": null, "source": "jobsdb", "list_url": "https://hk.jobsdb.com/api/jobsearch/v5/search?siteKey=HK-Main&keywords=software+engineer&page=1&pageSize=20", "scrapedAt": "2026-02-28T10:20:00.000Z", "companyProfileStructuredDataId": 408363, "displayType": "standard", "isFeatured": false, "listingDate": "2026-02-24T11:03:36Z", "roleId": "software-engineer", "workTypes": ["Full time"], "workArrangements": { "data": [{ "id": "1", "label": { "text": "On-site" } }] } } ``` *** ### Tips for Best Results #### Start with Small Limits - Begin with `results_wanted: 20` to validate your query quickly. - Increase gradually for production runs. #### Use Targeted Keywords - Specific keywords usually produce higher relevance than broad terms. - Combine role terms with locations when possible. #### Control Pagination - Use `maxPagesPerList` as a safety cap for predictable run times. - Keep page caps lower for scheduled jobs. #### Improve Reliability - Use proxy configuration for frequent or high-volume extraction. - Retry with narrower keywords if the market is very broad. *** ### Integrations - **Google Sheets** — Build live hiring trackers. - **Airtable** — Create searchable recruitment databases. - **Make** — Automate enrichment and downstream actions. - **Zapier** — Trigger alerts and workflows. - **Webhooks** — Send results to your own backend. #### Export Formats - **JSON** — Application and API workflows. - **CSV** — Spreadsheet and BI imports. - **Excel** — Business reporting. - **XML** — Legacy/system integrations. *** ### Frequently Asked Questions #### How many jobs can I collect? You can collect as many as available results and your input limits allow. Use `results_wanted` or `maxJobs` to control volume. #### Does it support both Thailand and Hong Kong? Yes. Set `country` to `th` or `hk` to target the corresponding market. #### Can I start from an existing JobsDB URL? Yes. Use `startUrl` to begin from a direct JobsDB search URL. #### Why are some fields empty? Some listings do not provide every field (for example salary), so values may be missing for specific ads. #### Is pagination handled automatically? Yes. The actor iterates pages until it reaches your limit or no more results are returned. *** ### Support For issues, improvements, or custom requirements, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is intended for legitimate data collection use cases. Users are responsible for compliance with applicable laws, platform terms, and internal data governance policies. # Actor input Schema ## `startUrl` (type: `string`): A JobsDB search URL. If provided, this will be used instead of Keyword/Location. E.g., https://th.jobsdb.com/jobs?q=developer ## `keyword` (type: `string`): Job search term, e.g., 'developer'. ## `location` (type: `string`): Geographic location to search in, e.g., 'Bangkok'. ## `country` (type: `string`): The JobsDB country domain to use for keyword/location searches. ## `posted_date` (type: `string`): Filter jobs by how recently they were posted (only works with keyword/location search). ## `results_wanted` (type: `integer`): The maximum number of jobs to collect. Leave empty to collect all available jobs. ## `maxPagesPerList` (type: `integer`): A safety cap on the number of search result pages to visit. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for the best results. Residential proxies are recommended. ## Actor input object example ```json { "keyword": "developer", "country": "th", "posted_date": "anytime", "results_wanted": 20, "maxPagesPerList": 50, "proxyConfiguration": { "useApifyProxy": 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "developer", "country": "th", "posted_date": "anytime", "results_wanted": 20, "maxPagesPerList": 50, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/jobsdb-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "developer", "country": "th", "posted_date": "anytime", "results_wanted": 20, "maxPagesPerList": 50, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/jobsdb-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "developer", "country": "th", "posted_date": "anytime", "results_wanted": 20, "maxPagesPerList": 50, "proxyConfiguration": { "useApifyProxy": false } }' | apify call shahidirfan/jobsdb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/jobsdb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobsdb Scraper", "description": "A lightweight actor to scrape job listings from Jobsdb, extracting details like title, company, and location. It's fast and easy to use. For the most reliable and consistent results, using residential proxies is strongly recommended to prevent getting blocked and ensure data accuracy.", "version": "0.0", "x-build-id": "SXaeVk30gfUzorfao" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~jobsdb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-jobsdb-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/shahidirfan~jobsdb-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-jobsdb-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/shahidirfan~jobsdb-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-jobsdb-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "A JobsDB search URL. If provided, this will be used instead of Keyword/Location. E.g., https://th.jobsdb.com/jobs?q=developer" }, "keyword": { "title": "Keyword (if not using Start URL)", "type": "string", "description": "Job search term, e.g., 'developer'." }, "location": { "title": "Location (if not using Start URL)", "type": "string", "description": "Geographic location to search in, e.g., 'Bangkok'." }, "country": { "title": "Country Site", "enum": [ "th", "hk" ], "type": "string", "description": "The JobsDB country domain to use for keyword/location searches.", "default": "th" }, "posted_date": { "title": "Posted Date Filter", "enum": [ "anytime", "24h", "7d", "30d" ], "type": "string", "description": "Filter jobs by how recently they were posted (only works with keyword/location search).", "default": "anytime" }, "results_wanted": { "title": "Maximum number of jobs", "minimum": 1, "type": "integer", "description": "The maximum number of jobs to collect. Leave empty to collect all available jobs.", "default": 20 }, "maxPagesPerList": { "title": "Maximum number of pages", "minimum": 1, "type": "integer", "description": "A safety cap on the number of search result pages to visit." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for the best results. Residential proxies are recommended." } } }, "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 } } } } } } } } } } ```