{ "openapi": "3.0.1", "info": { "title": "Thailand Job Market Intelligence", "description": "Searches multiple Thailand job boards and summarizes demand, salaries, skills, hiring companies, locations, and remote/hybrid trends.", "version": "0.2", "x-build-id": "qyj5jd4xOltsKO90m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mai_amm~thailand-job-market-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mai_amm-thailand-job-market-intelligence", "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/mai_amm~thailand-job-market-intelligence/runs": { "post": { "operationId": "runs-sync-mai_amm-thailand-job-market-intelligence", "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/mai_amm~thailand-job-market-intelligence/run-sync": { "post": { "operationId": "run-sync-mai_amm-thailand-job-market-intelligence", "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": "Keyword", "type": "string", "description": "Main job keyword, skill, or role to search for." }, "keywords": { "title": "Keywords", "type": "array", "description": "Additional keywords. Each keyword is searched across selected sources.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional province or city hint such as Bangkok, Chonburi, Chiang Mai, Remote." }, "sources": { "title": "Sources", "type": "array", "description": "Job boards to search. JobThai is collected through the dedicated owner Actor. JOBBKK, JOBTOPGUN, JobFinFin, Jooble, Joblum, and ThaiNGO are supported directly. LinkedIn and Indeed are URL mode only unless startUrls are provided.", "items": { "type": "string", "enum": [ "jobthai", "jobsdb", "jobbkk", "jobtopgun", "jobfinfin", "workventure", "jooble", "joblum", "thaingo", "linkedin", "indeed", "custom" ] }, "default": [ "jobthai", "jobsdb", "jobbkk", "jobtopgun", "jobfinfin", "workventure", "joblum" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional search or job detail URLs. Use this for LinkedIn, Indeed, or any custom source page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPagesPerSource": { "title": "Maximum pages per source (advanced)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Safety ceiling for listing pages. The Actor automatically uses enough pages to reach the requested job count.", "default": 10 }, "includeJobRecords": { "title": "Include job records", "type": "boolean", "description": "Save individual job records in addition to source and market summaries.", "default": true }, "includeDetails": { "title": "Open detail pages", "type": "boolean", "description": "Open a limited number of detail pages to enrich descriptions, skills, and salary. Leave off for faster large runs.", "default": false }, "includeContacts": { "title": "Include contacts", "type": "boolean", "description": "Include public contact emails/phones found in job pages. Disabled by default.", "default": false }, "useResidentialProxyForJobsDb": { "title": "Use residential proxy for JobsDB", "type": "boolean", "description": "JobsDB often blocks cloud/datacenter IPs. Keep this enabled when using the jobsdb source.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of HTTP requests running at the same time.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy configuration. Enabled by default because some job boards block Apify cloud IPs.", "default": { "useApifyProxy": true } }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Total number of unique job records to save. Free users can collect up to 20 jobs per run; users on a paid Apify plan can request any amount, subject to source availability and run timeout.", "default": 300 }, "includeSummaries": { "title": "Add summaries to dataset", "type": "boolean", "description": "Also append source and market summary rows after the job records. Leave off when the dataset row count must equal Maximum jobs.", "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 } } } } } } } } } }