{ "openapi": "3.0.1", "info": { "title": "JobsDB Scraper — Thailand & Hong Kong Jobs", "description": "Scrape JobsDB job listings from Thailand and Hong Kong. Returns 38 fields per job including the full description and parsed salary. Incremental mode returns only new, updated or expired listings with no speed penalty.", "version": "0.1", "x-build-id": "XhL9IP6gVDWFCooha" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/verybananadata~jobsdb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-verybananadata-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/verybananadata~jobsdb-scraper/runs": { "post": { "operationId": "runs-sync-verybananadata-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/verybananadata~jobsdb-scraper/run-sync": { "post": { "operationId": "run-sync-verybananadata-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": { "keyword": { "title": "Search keyword", "type": "string", "description": "Job title or keyword to search for on JobsDB. Example: 'software developer', 'accountant'. Leave empty to scrape all jobs in the selected country." }, "country": { "title": "Country site", "enum": [ "th", "hk" ], "type": "string", "description": "Which JobsDB country site to scrape. JobsDB operates in Thailand and Hong Kong. (Singapore now redirects to Jora; Malaysia and the Philippines moved to JobStreet.)", "default": "th" }, "location": { "title": "Location filter", "type": "string", "description": "City or region to filter jobs by. Example: 'Bangkok', 'Central Region'. Leave empty for all locations." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct JobsDB search result URLs to scrape. Use this instead of keyword/country when you already have a filtered search URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Maximum number of job listings to return. Set 0 for unlimited (bounded by maxPages).", "default": 50 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Maximum number of search result pages to crawl. Each page contains about 30 jobs.", "default": 5 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "How to order search results before scraping. 'date' returns newest jobs first, useful for monitoring.", "default": "relevance" }, "dateRange": { "title": "Posted within", "enum": [ "any", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only return jobs posted within this time window.", "default": "any" }, "workType": { "title": "Employment type", "enum": [ "any", "full-time", "part-time", "contract", "casual" ], "type": "string", "description": "Filter by employment type such as full time or contract.", "default": "any" }, "salaryMin": { "title": "Minimum salary", "type": "integer", "description": "Only return jobs with advertised salary at or above this amount, in local currency. Jobs without a listed salary are excluded when this is set." }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Include the complete job description text and HTML. Enabled by default because descriptions are fetched from the same response with no extra requests.", "default": true }, "incrementalMode": { "title": "Incremental mode (only changed jobs)", "type": "boolean", "description": "Return only jobs that are new, updated, or expired since the previous run with the same stateKey. Adds no extra requests, so runtime is unchanged. Use this for daily monitoring to avoid paying for unchanged listings.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Identifier for the incremental state store. Runs sharing the same stateKey compare against each other. Defaults to country+keyword when empty." }, "emitUnchanged": { "title": "Also emit unchanged jobs", "type": "boolean", "description": "When incremental mode is on, also return jobs that have not changed, marked as changeType=unchanged.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy is required because JobsDB blocks direct datacenter requests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }