{ "openapi": "3.0.1", "info": { "title": "JobsDB Scraper — Hong Kong Jobs & Salary Data", "description": "Scrape JobsDB Hong Kong job listings with salaries parsed into numbers (HKD min/max/period), normalised districts and industry classifications. Employer-side data only, no login.", "version": "0.1", "x-build-id": "t3cayMwWgasfJc4VY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hkdatafeeds~hong-kong-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hkdatafeeds-hong-kong-jobs-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/hkdatafeeds~hong-kong-jobs-scraper/runs": { "post": { "operationId": "runs-sync-hkdatafeeds-hong-kong-jobs-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/hkdatafeeds~hong-kong-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-hkdatafeeds-hong-kong-jobs-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": { "keywords": { "title": "Search keywords", "type": "string", "description": "Free-text search, e.g. 'accountant', 'python developer'. Leave empty to scrape the whole board (33,000+ live listings)." }, "classification": { "title": "Industry classification ID", "type": "string", "description": "Optional industry filter. 1200 = Accounting; 6251 = Administration & Office Support; 6304 = Advertising, Arts & Media; 1203 = Banking & Financial Services; 1204 = Call Centre & Customer Service; 7019 = CEO & General Management; 6163 = Community Services & Development; 1206 = Construction; 6076 = Consulting & Strategy; 6263 = Design & Architecture; 6123 = Education & Training; 1209 = Engineering; 6205 = Farming, Animals & Conservation; 1210 = Government & Defence; 1211 = Healthcare & Medical; 1212 = Hospitality & Tourism; 6317 = Human Resources & Recruitment; 6281 = Information & Communication Technology; 1214 = Insurance & Superannuation; 1216 = Legal; 6092 = Manufacturing, Transport & Logistics; 6008 = Marketing & Communications; 6058 = Mining, Resources & Energy; 1220 = Real Estate & Property; 6043 = Retail & Consumer Products; 6362 = Sales; 1223 = Science & Technology; 6261 = Self Employment; 6246 = Sport & Recreation; 1225 = Trades & Services." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 40000, "type": "integer", "description": "Hard cap on how many listings to return. The whole board is about 33,000 live listings; above 30,000 the Actor splits the search by industry to get past the source's paging limit. The run also stops at the number of listings your Maximum cost per run pays for.", "default": 200 }, "requestDelaySeconds": { "title": "Delay between requests (seconds)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Politeness delay. Keep at 1 or higher to stay well-behaved.", "default": 1 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }