{
"openapi": "3.0.1",
"info": {
"title": "518 Job Scraper — Taiwan Service, Retail & Part-Time Jobs",
"description": "Scrape jobs from 518 熊班 (518.com.tw), Taiwan's biggest board for retail, food service, logistics, hourly and part-time work. Titles, employers, hourly/monthly pay parsed to numbers, city/district, experience, posted date and full descriptions as clean JSON.",
"version": "1.0",
"x-build-id": "4DxYB9aC8iQG7SCaX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/youfuxu~taiwan-518-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-youfuxu-taiwan-518-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/youfuxu~taiwan-518-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-youfuxu-taiwan-518-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/youfuxu~taiwan-518-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-youfuxu-taiwan-518-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",
"required": [
"keyword"
],
"properties": {
"keyword": {
"title": "Search keyword",
"type": "string",
"description": "What to search for, in Chinese or English — e.g. 門市 (retail store), 餐飲 (food service), 倉儲 (warehouse), 清潔, 司機, python. 518 is a blue-collar / service-industry board, so Chinese job words return far more results than tech keywords.",
"default": "門市"
},
"region": {
"title": "City / county",
"enum": [
"",
"3001001",
"3001002",
"3001019",
"3001003",
"3001004",
"3001025",
"3001012",
"3001005",
"3001010",
"3001017",
"3001015",
"3001013",
"3001026",
"3001008",
"3001006",
"3001014",
"3001016",
"3001018",
"3001020",
"3001022",
"3001021",
"3001023",
"3001024"
],
"type": "string",
"description": "Limit results to one Taiwanese city or county. Leave as All Taiwan to search nationwide.",
"default": ""
},
"jobType": {
"title": "Job type",
"enum": [
"",
"1",
"2",
"3"
],
"type": "string",
"description": "518's own job-nature filter. Full-time = 全職, Part-time = 兼職, Casual / hourly = 打工 (short shifts, students, seasonal). When a type is selected every result is tagged with it for sure; with Any the employmentType field is inferred from the title and pay basis.",
"default": ""
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"newest"
],
"type": "string",
"description": "How 518 should order the results before the scraper walks them.",
"default": "relevance"
},
"maxItems": {
"title": "Max jobs",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of jobs to return (518 pages 32 at a time). Keep it small for a quick test, raise it for a full export.",
"default": 50
},
"includeDetails": {
"title": "Include detail page data",
"type": "boolean",
"description": "Visit each job page to add the exact posted date and expiry, the employer-stated job type, full HTML description, job category, number of openings, work hours, days off, education requirement, contact person, industry, company website and logo. One extra request per job (about 1.5 s each), so it is slower — the list already gives title, company, pay, location, experience and a description excerpt without it.",
"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
}
}
}
}
}
}
}
}
}
}