{ "openapi": "3.0.1", "info": { "title": "Hello Work Japan Jobs — Openings & Wages by Prefecture", "description": "Enter a keyword and prefecture and get how many jobs are open and what they pay on Hello Work, Japan's public job service. Returns the exact opening count, then from the 60 newest ads the median starting wage, its range and the permanent vs part-time mix. $0.02 per keyword × prefecture. Unofficial.", "version": "0.1", "x-build-id": "MKzQr5pVluOTdHf6v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~japan-public-jobs-market-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-japan-public-jobs-market-checker", "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/jpmarketdata~japan-public-jobs-market-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-japan-public-jobs-market-checker", "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/jpmarketdata~japan-public-jobs-market-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-japan-public-jobs-market-checker", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Job keywords to analyze — occupation, skill, employer or qualification. Postings are written in Japanese, so a Japanese word is what finds them (看護師, 介護, 経理, 溶接, 保育士). Latin letters and digits are sent full-width (IT -> ＩＴ), which is how Hello Work stores them — that is the only way they match at all, and it finds the postings that use the Latin word themselves (measured 2026-08-18, Tokyo: IT 7,079 openings, python 34). An English word for a Japanese job title finds nothing (Nurse 0, 看護師 5,684): matching is literal, never translated. Each keyword x prefecture combination costs $0.02.", "default": [ "看護師" ], "items": { "type": "string" } }, "prefectures": { "title": "Prefectures", "type": "array", "description": "One or more prefectures. Accepts JIS codes (13, 27, 39), English names (Tokyo, Osaka, Kochi) or Japanese names (東京都, 大阪府). Use [\"all\"] for all 47 prefectures — note that costs $0.02 per prefecture and needs several runs to fit the time budget.", "default": [ "13" ], "items": { "type": "string" } }, "jobCategory": { "title": "Job category", "enum": [ "1", "4" ], "type": "string", "description": "Hello Work's 求人区分. 'General' covers ordinary full-time and part-time openings (the vast majority). 'Seasonal migrant work' (出稼ぎ) is a small, separate register.", "default": "1" }, "maxPagesPerSlice": { "title": "Result pages sampled per keyword x prefecture", "minimum": 1, "maximum": 5, "type": "integer", "description": "Hello Work returns a fixed 30 jobs per page, so 2 pages = up to 60 sampled jobs per combination. More pages give steadier wage medians but add ~2 seconds each. The total opening count is exact regardless of this setting.", "default": 2 }, "includeIndividualJobs": { "title": "Include individual job postings", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per keyword x prefecture summary. Enable to also get every sampled posting (job number, occupation, employer, location, wage range, dates) at +$0.002 per job. Contact names and phone numbers are never collected.", "default": false }, "convertToUsd": { "title": "Also report wages in USD", "type": "boolean", "description": "Adds a USD copy of every wage statistic plus the exchange rate used. Wages are always reported in JPY as well.", "default": false } } }, "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 } } } } } } } } } }