{ "openapi": "3.0.1", "info": { "title": "en-japan Jobs Scraper (Japan)", "description": "Scrape job listings from employment.en-japan.com (エン転職), a major Japanese mid-career job board: job id and URL, title, company, location, salary text with yen band where stated, employment type, tags - by area, occupation, keyword or new arrivals.", "version": "0.1", "x-build-id": "xqHr4VJ0RKdRnM4SQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~enjapan-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-enjapan-jobs", "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/superslowsloth~enjapan-jobs/runs": { "post": { "operationId": "runs-sync-superslowsloth-enjapan-jobs", "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/superslowsloth~enjapan-jobs/run-sync": { "post": { "operationId": "run-sync-superslowsloth-enjapan-jobs", "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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional. en-japan search result URLs, copied from your browser after setting conditions on employment.en-japan.com - they must be on https://employment.en-japan.com/search/search_list/ and carry at least one condition. Every condition in the URL is kept; the page number is managed by the actor. When you give URLs, the area, occupation, keyword and new-arrivals fields below are ignored. All URLs share the maxItems budget, in the order given.", "items": { "type": "string" } }, "areaIds": { "title": "Area IDs", "type": "array", "description": "Optional. en-japan area ids, e.g. 23 for Tokyo. Each area is its own search. Used only when Search URLs is empty. An id en-japan does not know is ignored by the site: on its own the search then returns no jobs, next to other conditions it returns jobs from every area.", "items": { "type": "string" } }, "occupationIds": { "title": "Occupation IDs", "type": "array", "description": "Optional. en-japan occupation ids, e.g. 100000 for the whole sales group (営業系) or 101000 for corporate sales (法人営業). Each occupation is its own search (combined with each area), which is how to read past the 2,000-job ceiling en-japan puts on any single search. Used only when Search URLs is empty. An id en-japan does not know is ignored by the site and returns the unfiltered search.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional. A keyword searched across en-japan job text, e.g. エンジニア. Used only when Search URLs is empty." }, "newOnly": { "title": "New arrivals only", "type": "boolean", "description": "Keep only jobs en-japan flags as new arrivals (its 新着のみ filter). This is the daily-feed switch: a Tokyo search that returns 6,266 jobs returned 526 with it on. Used only when Search URLs is empty.", "default": false }, "fetchDetails": { "title": "Fetch posting dates", "type": "boolean", "description": "Open every job's detail page to fill posted_from, posted_until and last_updated, which the search results do not show. Costs one extra request per job, so runs are slower; the price per job is unchanged. Off by default: those three columns are then null.", "default": false }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many jobs in total, shared across every search. en-japan shows 50 jobs per page, so every 50 jobs is one page request. A single search never returns more than 2,000 jobs, however many en-japan reports.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy is the default: employment.en-japan.com answered datacenter exits with full pages on 2026-10-23. Residential is not needed and costs more.", "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 }, "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 } } } } } } } } } }