{ "openapi": "3.0.1", "info": { "title": "Zhaopin Scraper", "description": "[💰 $1.7 / 1K] Scrape jobs from Zhaopin (智联招聘), one of China's largest recruitment platforms. Get title, company, city, salary, experience, education & posted date, plus optional full descriptions, company profiles & HR contacts. Filter by keyword, city, salary, experience & more.", "version": "1.0", "x-build-id": "t8rdA3BDSL0bHjsrN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~zhaopin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-zhaopin-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/solidcode~zhaopin-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-zhaopin-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/solidcode~zhaopin-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-zhaopin-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": { "query": { "title": "Search Keyword", "type": "string", "description": "Job title, skill, or keyword to search for. Works in Chinese or English (e.g. 'python', '销售', 'java工程师', '产品经理'). Leave blank to collect all jobs matching the filters below." }, "city": { "title": "City", "uniqueItems": true, "type": "array", "description": "Only include jobs in these Chinese cities. Leave empty to search nationwide. Selecting more than one runs a separate search per city and combines the results — this multiplies the work, so keep the 'Maximum Results' cap in mind when picking several.", "items": { "type": "string", "enum": [ "530", "538", "765", "763", "531", "736", "854", "801", "600", "613", "599", "635", "702", "703", "653", "639", "636", "654", "551", "719", "749", "681", "682", "622" ], "enumTitles": [ "Beijing (北京)", "Shanghai (上海)", "Shenzhen (深圳)", "Guangzhou (广州)", "Tianjin (天津)", "Wuhan (武汉)", "Xi'an (西安)", "Chengdu (成都)", "Dalian (大连)", "Changchun (长春)", "Shenyang (沈阳)", "Nanjing (南京)", "Jinan (济南)", "Qingdao (青岛)", "Hangzhou (杭州)", "Suzhou (苏州)", "Wuxi (无锡)", "Ningbo (宁波)", "Chongqing (重庆)", "Zhengzhou (郑州)", "Changsha (长沙)", "Fuzhou (福州)", "Xiamen (厦门)", "Harbin (哈尔滨)" ] } }, "salary": { "title": "Monthly Salary Range", "enum": [ "", "0000,4000", "4001,6000", "6001,8000", "8001,10000", "10001,15000", "15001,25000", "25001,35000", "35001,50000", "50001,9999999" ], "type": "string", "description": "Only include jobs within this monthly salary band (in Chinese Yuan, RMB). Leave on 'Any' to include all salaries." }, "experience": { "title": "Experience Required", "uniqueItems": true, "type": "array", "description": "Only include jobs requiring these experience levels. Leave empty to include any. Selecting several values runs a separate search for each and merges the results.", "items": { "type": "string", "enum": [ "-1", "0001", "0103", "0305", "0510", "1099" ], "enumTitles": [ "Experience unlimited", "Under 1 year", "1 – 3 years", "3 – 5 years", "5 – 10 years", "Over 10 years" ] } }, "education": { "title": "Education Level", "uniqueItems": true, "type": "array", "description": "Only include jobs asking for these education levels. Leave empty to include any. Selecting several values runs a separate search for each and merges the results.", "items": { "type": "string", "enum": [ "9", "7", "12", "5", "4", "3", "10", "1" ], "enumTitles": [ "Junior high & below (初中及以下)", "High school (高中)", "Vocational secondary (中专/中技)", "College / Associate (大专)", "Bachelor's (本科)", "Master's (硕士)", "MBA / EMBA", "Doctorate (博士)" ] } }, "employmentType": { "title": "Employment Type", "uniqueItems": true, "type": "array", "description": "Only include jobs with these employment types. Leave empty to include any. Selecting several values runs a separate search for each and merges the results.", "items": { "type": "string", "enum": [ "2", "1", "4", "5" ], "enumTitles": [ "Full-time (全职)", "Part-time (兼职/临时)", "Internship (实习)", "Campus recruitment (校园招聘)" ] } }, "startUrls": { "title": "Search URLs", "type": "array", "description": "Advanced: paste zhaopin.com search URLs built in the site's own search page (e.g. https://sou.zhaopin.com/?jl=530&kw=python). Use this when you've already applied filters in the site UI. When provided, the keyword and filters above are ignored for these URLs.", "items": { "type": "string" } }, "includeDetails": { "title": "Fetch Full Job Details", "type": "boolean", "description": "Off by default for fast results. Each job card already includes the title, company, city, salary, experience, education and posted date. Turn this on to also fetch the full job description, company profile (size, industry, funding stage), benefit tags, exact address with map coordinates, and the HR contact from each job's own page — this is slower, because every job needs an extra page visit, so expect longer runs on large searches.", "default": false }, "extractContacts": { "title": "Extract Emails & Phone Numbers", "type": "boolean", "description": "When full job details are fetched, also scan each description for contact emails and phone numbers and add them as separate fields. Useful for recruitment lead generation. Has no effect unless 'Fetch Full Job Details' is on.", "default": false }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on the total number of jobs returned across all searches and URLs. Default 100 — increase for bigger runs, or set to 0 to collect everything (up to a safety ceiling of 100,000 results). Each result is billed at the per-result rate. The actor stops requesting new pages once this number is hit but keeps the full last page even if it slightly overshoots.", "default": 100 } } }, "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 } } } } } } } } } }