{
  "openapi": "3.0.1",
  "info": {
    "title": "Zhaopin Jobs Scraper - China Jobs, Salaries, Companies & Emails",
    "description": "Scrape Zhaopin (智联招聘) jobs by keyword, city, district and every site filter: full description, CNY salary as numbers with 13/14薪, map point, recruiter reply signals, company details, business registration and employer email. Monitor mode. $0.89 per 1,000 jobs.",
    "version": "0.1",
    "x-build-id": "jTJfdzStexoIo0edO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~zhaopin-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-zhaopin-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/topapi~zhaopin-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-zhaopin-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/topapi~zhaopin-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-zhaopin-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": {
          "searchKeywords": {
            "title": "Keywords",
            "type": "array",
            "description": "What to search for, as in Zhaopin's search box: a job title, skill or company name in Chinese or English, for example \"数据分析\", \"销售\", \"Python\", \"产品经理\" or \"会计\". Each keyword is its own search with every city. Leave empty for every job in the cities below (newest first).",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities, districts or provinces",
            "type": "array",
            "description": "Where the jobs are: a city (\"上海\", \"Beijing\", \"深圳\", \"Hangzhou\"), a district (\"浦东新区\", \"南山区\"), a province (\"广东\") or a Zhaopin code (538 = Shanghai, 530 = Beijing, 765 = Shenzhen, 763 = Guangzhou, 653 = Hangzhou, 489 = all of China). Each place is its own search with every keyword. Leave empty for all of China.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Zhaopin links",
            "type": "array",
            "description": "Links copied from zhaopin.com, mixed freely: job pages (www.zhaopin.com/jobdetail/CC...htm or jobs.zhaopin.com/CC...htm), search pages with their filters (www.zhaopin.com/jobs/?jl=538&kw=python&el=4, sou.zhaopin.com/?jl=530&kw=java, www.zhaopin.com/sou/jl538/kw...) and company pages (company.zhaopin.com/CZ...htm: that company's open jobs). A search link keeps its own filters.",
            "items": {
              "type": "string"
            }
          },
          "jobIds": {
            "title": "Job numbers",
            "type": "array",
            "description": "Zhaopin job numbers (the CC... code in a job link, e.g. CC534044020J40940808312). Each one is read from its job page's own record.",
            "items": {
              "type": "string"
            }
          },
          "salaryMin": {
            "title": "Minimum monthly salary (CNY)",
            "minimum": 0,
            "type": "integer",
            "description": "Jobs whose monthly salary range reaches at least this amount, e.g. 15000. Sent to Zhaopin as a salary range and checked exactly on each job (jobs paid by the day or hour, and \"面议\" negotiable salaries, are left out when this is set)."
          },
          "salaryMax": {
            "title": "Maximum monthly salary (CNY)",
            "minimum": 0,
            "type": "integer",
            "description": "Jobs whose monthly salary range starts at or below this amount, e.g. 30000."
          },
          "salaryBand": {
            "title": "Salary band (Zhaopin's own)",
            "enum": [
              "",
              "0000,4000",
              "4001,6000",
              "6001,8000",
              "8001,10000",
              "10001,15000",
              "15001,25000",
              "25001,35000",
              "35001,50000",
              "50001,9999999"
            ],
            "type": "string",
            "description": "One of Zhaopin's monthly salary bands (CNY). Ignored when a minimum or maximum salary is set."
          },
          "education": {
            "title": "Education",
            "type": "array",
            "description": "The education the job asks for (Zhaopin's own filter). API callers can also send names: \"bachelor\", \"本科\", \"master\".",
            "items": {
              "type": "string",
              "enum": [
                "9",
                "7",
                "12",
                "5",
                "4",
                "3",
                "10",
                "1"
              ],
              "enumTitles": [
                "Junior high or below / 初中及以下",
                "High school / 高中",
                "Secondary vocational / 中专/中技",
                "Associate / 大专",
                "Bachelor / 本科",
                "Master / 硕士",
                "MBA/EMBA",
                "Doctorate / 博士"
              ]
            }
          },
          "experience": {
            "title": "Experience",
            "type": "array",
            "description": "The work experience the job asks for (Zhaopin's own filter).",
            "items": {
              "type": "string",
              "enum": [
                "-1",
                "0001",
                "0103",
                "0305",
                "0510",
                "1099"
              ],
              "enumTitles": [
                "No experience needed / 经验不限",
                "Under 1 year / 1年以下",
                "1-3 years / 1-3年",
                "3-5 years / 3-5年",
                "5-10 years / 5-10年",
                "Over 10 years / 10年以上"
              ]
            }
          },
          "jobType": {
            "title": "Job type",
            "type": "array",
            "description": "Full-time, part-time, internship or campus jobs (Zhaopin's own filter).",
            "items": {
              "type": "string",
              "enum": [
                "2",
                "1",
                "4",
                "5"
              ],
              "enumTitles": [
                "Full-time / 全职",
                "Part-time / 兼职",
                "Internship / 实习",
                "Campus hiring / 校园"
              ]
            }
          },
          "companyType": {
            "title": "Company type",
            "type": "array",
            "description": "The employer's ownership (Zhaopin's own filter).",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "4",
                "16",
                "5",
                "6;10",
                "7;14;15"
              ],
              "enumTitles": [
                "State-owned / 国企",
                "Foreign / 外企",
                "Joint venture / 中外合资",
                "Hong Kong, Macau, Taiwan / 港澳台企业",
                "Private / 民营",
                "Government or public institution / 机关/事业单位",
                "Other / 其他"
              ]
            }
          },
          "companySize": {
            "title": "Company size",
            "type": "array",
            "description": "Number of employees (Zhaopin's own filter).",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "8",
                "4",
                "5",
                "6"
              ],
              "enumTitles": [
                "Under 20 / 20人以下",
                "20-99",
                "100-299",
                "300-499",
                "500-999",
                "1000-9999",
                "10000+ / 10000人以上"
              ]
            }
          },
          "financingStage": {
            "title": "Financing stage",
            "type": "array",
            "description": "The employer's financing stage (Zhaopin's own filter).",
            "items": {
              "type": "string",
              "enum": [
                "7",
                "2;3;4;5;6",
                "8",
                "1"
              ],
              "enumTitles": [
                "Listed / 已上市",
                "Funded / 有融资",
                "No funding needed / 不需要融资",
                "Not funded / 未融资"
              ]
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Zhaopin industries by Chinese or English name or code, e.g. \"软件/IT服务\", \"Automobile\", \"1600000000\". All of them go into one search.",
            "items": {
              "type": "string"
            }
          },
          "jobCategories": {
            "title": "Job categories",
            "type": "array",
            "description": "Zhaopin job categories by Chinese or English name or code, e.g. \"数据分析师\", \"Data Analyst\", \"销售顾问\", \"Sales Consultant\". Each category is its own search with every keyword and city.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "salary"
            ],
            "type": "string",
            "description": "Zhaopin's own order. Monitor mode and a posted-within window always read newest first.",
            "default": "relevance"
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs posted or refreshed in the last N days (Zhaopin's publish time). The search then reads newest first and stops at older jobs."
          },
          "postedAfter": {
            "title": "Posted after (date)",
            "type": "string",
            "description": "Only jobs posted or refreshed on or after this date (China time), e.g. 2026-11-01."
          },
          "titleKeywords": {
            "title": "Title must contain one of",
            "type": "array",
            "description": "Keep a job only when its title contains one of these words, e.g. \"经理\", \"Python\".",
            "items": {
              "type": "string"
            }
          },
          "titleMustMatchKeyword": {
            "title": "Title must contain the search keyword",
            "type": "boolean",
            "description": "Keep a job only when every word of its search keyword is in the title (Zhaopin also matches descriptions and related titles).",
            "default": false
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Leave out jobs whose title or company contains one of these words, e.g. \"实习\", \"兼职\", \"外包\".",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude companies",
            "type": "array",
            "description": "Leave out jobs from companies whose name contains one of these.",
            "items": {
              "type": "string"
            }
          },
          "companyNames": {
            "title": "Only these companies",
            "type": "array",
            "description": "Keep only jobs from companies whose name contains one of these (or with this Zhaopin company number, CZ...). To read one company's jobs, a company link above is cheaper.",
            "items": {
              "type": "string"
            }
          },
          "onlyWithSalary": {
            "title": "Only jobs with a stated salary",
            "type": "boolean",
            "description": "Leave out jobs whose salary is \"面议\" (negotiable).",
            "default": false
          },
          "excludeAgencyPostings": {
            "title": "Direct employers only",
            "type": "boolean",
            "description": "Leave out jobs posted by a recruitment agency for a client (Zhaopin's \"代招岗位\" label).",
            "default": false
          },
          "minRecruiterResponsiveness": {
            "title": "Minimum recruiter responsiveness (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep jobs whose recruiter scores at least this on the 0-100 responsiveness score built from Zhaopin's own badges (high reply rate, replies today, expected reply time, last active). See the README for the formula."
          },
          "maxItemsPerCompany": {
            "title": "Maximum jobs per company",
            "minimum": 0,
            "type": "integer",
            "description": "At most this many jobs from one company (0 = no limit)."
          },
          "lat": {
            "title": "Near latitude",
            "minimum": -90,
            "maximum": 90,
            "type": "number",
            "description": "With a longitude and a radius: keep jobs whose work place is within the radius of this point (every job carries Zhaopin's coordinates). E.g. 31.2304."
          },
          "lon": {
            "title": "Near longitude",
            "minimum": -180,
            "maximum": 180,
            "type": "number",
            "description": "E.g. 121.4737."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "type": "number",
            "description": "E.g. 5."
          },
          "includeDetails": {
            "title": "Include job details (free)",
            "type": "boolean",
            "description": "Adds each job page's own record at no extra charge: company description, financing stage, all its industries, open jobs at the company, licence check, apply link, benefits, bonus, recruiter last active and verified badge, review and interview counts.",
            "default": true
          },
          "includeCompanyProfile": {
            "title": "Include company profile (free)",
            "type": "boolean",
            "description": "Adds the company page's record at no extra charge (read once per company): website, head office address and every address, company benefits, work hours, rest days, overtime, honours, affiliated companies, group flag.",
            "default": false
          },
          "includeCompanyRegistration": {
            "title": "Include business registration (free)",
            "type": "boolean",
            "description": "Adds the business registration card Zhaopin shows on the company page (read once per company, no extra charge): registered name, unified social credit code, legal representative, registered capital, registration date and status, legal form, registered industry and address, registration authority, business period and scope.",
            "default": false
          },
          "enrichEmails": {
            "title": "Find employer emails (paid add-on)",
            "type": "boolean",
            "description": "For each company with a website on its Zhaopin page, reads the website (home page and up to 3 contact / about pages) and adds the email it publishes (hiring or general inbox first). Charged once per employer whose email was found (see Pricing); companies without a website or an email on it are not charged. Switches on the company profile.",
            "default": false
          },
          "marketSummary": {
            "title": "Market summary rows (paid add-on)",
            "type": "boolean",
            "description": "Adds one summary row per search, computed from the jobs it read: monthly salary median, quartiles and range, salary months, annual and daily medians, salary by city, top companies, districts, job categories, industries and skills, job types, education, experience, company types and sizes, agency share, recruiter responsiveness median, posting dates. Charged per summary row.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "How the job description is delivered.",
            "default": "text"
          },
          "descriptionMaxLength": {
            "title": "Cut descriptions at (characters)",
            "minimum": 0,
            "type": "integer",
            "description": "0 = the whole description."
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop fields that are empty for a job (smaller rows; the columns then differ from row to row).",
            "default": false
          },
          "maxItems": {
            "title": "Maximum jobs in total",
            "minimum": 0,
            "type": "integer",
            "description": "The run stops after this many jobs (0 = no limit). Zhaopin serves up to 1,000 jobs per search; a larger search is split by district (or a province by city) automatically.",
            "default": 50
          },
          "maxItemsPerSearch": {
            "title": "Maximum jobs per search",
            "minimum": 0,
            "type": "integer",
            "description": "At most this many jobs from each keyword x city search (0 = no limit)."
          },
          "maxPagesPerSearch": {
            "title": "Maximum pages per search",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Zhaopin pages of 20 jobs read per search (0 = all, up to 50)."
          },
          "splitLargeSearches": {
            "title": "Split searches deeper than 1,000 jobs",
            "type": "boolean",
            "description": "When a search fills Zhaopin's 1,000-job limit and the run wants more, it is read again district by district (a province city by city, all of China province by province).",
            "default": true
          },
          "monitorMode": {
            "title": "Only new jobs (monitor mode)",
            "type": "boolean",
            "description": "Each run returns only jobs not delivered by earlier runs of the same input (and jobs whose title, salary, place or description changed). Schedule the run daily to get each day's new jobs. Jobs already delivered are not charged again.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate memories for separate monitors with the same input (letters, digits and dashes).",
            "default": "default"
          },
          "includeUnchanged": {
            "title": "Also return unchanged jobs",
            "type": "boolean",
            "description": "Monitor mode: also deliver (and charge) jobs seen before and unchanged, marked changeType UNCHANGED.",
            "default": false
          },
          "emitBaseline": {
            "title": "Deliver the first run",
            "type": "boolean",
            "description": "Monitor mode: off = the first run only records what exists now (nothing delivered or charged) and later runs return what is new.",
            "default": true
          },
          "resetMonitor": {
            "title": "Reset the monitor memory",
            "type": "boolean",
            "description": "Forget what earlier runs delivered and start again.",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "After the run, POST a JSON message with the number of new jobs and the first ones (title, company, place, salary, link)."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "A Slack incoming-webhook URL for the same message."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "A Discord webhook URL for the same message."
          },
          "teamsWebhookUrl": {
            "title": "Microsoft Teams webhook URL",
            "type": "string",
            "description": "A Teams incoming-webhook URL for the same message."
          },
          "telegramToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "With a chat id: the same message to a Telegram chat."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat that receives the message."
          },
          "ntfyTopic": {
            "title": "ntfy topic",
            "type": "string",
            "description": "An ntfy.sh topic for a push notification."
          },
          "notificationLimit": {
            "title": "Jobs listed per alert",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many jobs the message lists.",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Job and company records read at the same time.",
            "default": 16
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: Zhaopin answers without a proxy. The run moves to Apify proxies by itself (datacenter, then residential in China) if the site refuses it. A chosen Apify proxy group is used when the direct connection is refused; your own proxy URLs are used first.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}