{ "openapi": "3.0.1", "info": { "title": "Engage Scraper: en-gage.net Japan Jobs & Pay [USD 0.69/1K]", "description": "Scrape Engage (en-gage.net) jobs in Japan from the site's sitemaps, recently updated first: title, company, prefecture, town, pay in JPY with its period, employment type, occupation, hours, nearest station and full description. USD 0.69 per 1,000 jobs.", "version": "1.0", "x-build-id": "8dyln4ixYlAMF9Sst" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/usefulapi~engage-japan-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-usefulapi-engage-japan-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/usefulapi~engage-japan-jobs-scraper/runs": { "post": { "operationId": "runs-sync-usefulapi-engage-japan-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/usefulapi~engage-japan-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-usefulapi-engage-japan-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": { "startUrls": { "title": "Job page URLs (optional)", "type": "array", "description": "Engage job pages to read directly, for example https://en-gage.net/user/search/desc/18255559/. When given, the Actor reads only these pages and ignores the sitemap options below (the filters still apply).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "updatedWithinDays": { "title": "Jobs updated in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Without job page URLs the Actor takes job addresses from Engage's own sitemaps, newest update first, and keeps those whose sitemap date is within this many days. 0 = no limit (the sitemaps also hold years-old ads that are still online).", "default": 30 }, "prefectures": { "title": "Prefectures (any of)", "type": "array", "description": "Keep only jobs in these prefectures (Tokyo, Osaka, Hokkaido, or 東京都, 大阪府). Engage's sitemaps do not say where a job is, so every job page is read first: a narrow filter reads many pages per job kept (about 1.5 s each).", "items": { "type": "string" } }, "keywords": { "title": "Words in the job (any of)", "type": "array", "description": "Keep only jobs whose headline, company, occupation, place or description contains one of these words (Japanese works best, for example エンジニア or 介護). The job page is read before the check, so a rare word reads many pages.", "items": { "type": "string" } }, "employmentType": { "title": "Employment type (optional)", "enum": [ "", "full-time", "part-time", "contract", "temporary", "freelance" ], "type": "string", "description": "Keep only jobs of this type, from the ad's own employment type." }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after saving this many jobs (across all searches). You pay only for jobs saved.", "default": 50 }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only jobs published in the last N days. 0 = any date.", "default": 0 }, "onlyNewJobs": { "title": "Only new jobs since the last run", "type": "boolean", "description": "Remembers the jobs already delivered for these searches (in a key-value store on your account) and saves only jobs not seen before. Ideal for daily or hourly schedules and job alerts. The first run delivers everything and remembers it.", "default": false }, "stateKey": { "title": "Memory name for new-jobs mode (optional)", "pattern": "^[A-Za-z0-9_-]{0,60}$", "type": "string", "description": "Use the same name on several schedules to share one memory, or a new name to start fresh. Letters, digits, - and _. Empty = one memory per set of searches." }, "includeDetails": { "title": "Open each job page for full details", "type": "boolean", "description": "Reads each job's own page for the full description and extra fields. Turn off for faster runs with list fields only (same price per job).", "default": true }, "notifyUrl": { "title": "Send new jobs to (optional)", "pattern": "^(https://.+)?$", "type": "string", "description": "Paste a Slack or Discord webhook link, or a Zapier or Make webhook (which can email you). After each run that saved jobs you get one message with the count and up to 10 jobs with their links. With 'Only new jobs' on and a schedule, this is a free job alert. Not billed." }, "descriptionFormat": { "title": "Description format", "enum": [ "both", "text", "html", "none" ], "type": "string", "description": "Plain text, HTML, both, or none (smaller datasets).", "default": "both" }, "maxJobsPerSearch": { "title": "Maximum jobs per search", "minimum": 0, "type": "integer", "description": "Cap for each search line, so one broad search does not use up the whole run. 0 = no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for Engage (en-gage.net) in our tests. Apify datacenter proxy or your own proxies only; residential proxy is not supported.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }