{ "openapi": "3.0.1", "info": { "title": "Liepin Scraper 猎聘 - China Jobs, Salaries & Recruiters", "description": "Scrape jobs from Liepin (liepin.com, 猎聘), China's white-collar and headhunter job board. Get title, salary range, city, experience, education, company profile and the recruiter behind each job. Search by keyword and city. No proxy setup. JSON or CSV.", "version": "0.0", "x-build-id": "jtxZv78YGOKjjubBX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~liepin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-liepin-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/memo23~liepin-scraper/runs": { "post": { "operationId": "runs-sync-memo23-liepin-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/memo23~liepin-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-liepin-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": { "searchTerms": { "title": "Keywords", "type": "array", "description": "Job keywords, in Chinese or English, e.g. `python`, `销售`, `产品经理`, `Java`.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Cities to search. Use Chinese names (`北京`, `上海`, `深圳`), pinyin (`beijing`, `shenzhen`) or Liepin city codes (`010`). Leave empty for nationwide. Each keyword is searched in each city.", "items": { "type": "string" } }, "pagesPerQuery": { "title": "Pages per keyword × city", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many result pages (about 40 jobs each) to read for every keyword × city pair. Liepin serves at most 10 pages per search, so add more cities to go wider.", "default": 10 }, "includeJobDetail": { "title": "Include full job details", "type": "boolean", "description": "Also open each job page for the full description, company address and headcount. Slower; search results already include salary, company and recruiter.", "default": false }, "startUrls": { "title": "Liepin search / job URLs", "type": "array", "description": "Paste Liepin search URLs (`https://www.liepin.com/zhaopin/?key=…&dq=…`) or job URLs (`https://www.liepin.com/job/….shtml`) — each is auto-routed.", "items": { "type": "string" } }, "onlyChanged": { "title": "Only new or changed jobs (monitor mode)", "type": "boolean", "description": "Remember jobs between runs and deliver only those that are new or changed since the last run. Unchanged jobs are skipped before billing.", "default": false }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Hard cap on jobs collected (and billed).", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency (job pages)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel job-page requests when full details are on. Search pages are always read one at a time.", "default": 8 } } }, "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 } } } } } } } } } }