# Zhaopin Jobs Scraper - China Jobs, Salaries, Companies & Emails (`topapi/zhaopin-jobs-scraper`) Actor

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.

- **URL**: https://apify.com/topapi/zhaopin-jobs-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.89 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Zhaopin Jobs Scraper - 智联招聘 China Jobs, Salaries, Companies & Emails

Scrape job vacancies from **[Zhaopin (智联招聘, zhaopin.com)](https://www.zhaopin.com)**, one of China's largest job boards,
by keyword, city, district or province, with every filter the site has. Each job comes back as one clean row: the full
description, the salary as numbers (monthly min / max, 13薪 / 14薪 months, annual range), the work address with map
coordinates, education, experience, job type and category (Chinese and English), skills, and the recruiter's reply
signals turned into a 0-100 responsiveness score. Job details (company description, financing stage, industries, apply
link, recruiter last online) are included at no extra charge. No login, no cookies.

Optional: the company profile (website, head office, benefits, work hours), the company's business registration
(unified social credit code, legal representative, registered capital, status), the employer's email from its own
website, a market summary row per search, and monitor mode that returns only new jobs on scheduled runs.

### What you can search

| Input | Example |
|---|---|
| Keywords (Chinese or English) | `数据分析`, `销售`, `Python`, `产品经理`, a company name |
| Cities, districts, provinces | `上海`, `Beijing`, `深圳`, `浦东新区`, `南山区`, `广东`, or Zhaopin codes (`538`, `530`, `489` = all of China) |
| Zhaopin links | search pages (`www.zhaopin.com/jobs/?jl=538&kw=python&el=4`, `sou.zhaopin.com/?jl=530&kw=java`, `www.zhaopin.com/sou/jl538/kw...`), job pages (`www.zhaopin.com/jobdetail/CC...htm`), company pages (`company.zhaopin.com/CZ...htm` = that company's open jobs) |
| Job numbers | `CC534044020J40940808312` |

Each keyword x city (x job category) is one search. Zhaopin serves up to **1,000 jobs per search** (50 pages of 20); when
a search fills that and you want more, the actor reads it again district by district (a province city by city, all of
China province by province). Measured: `python` in Shanghai with no limit gave **1,880 unique jobs** that way.

#### Zhaopin's own filters (applied in Zhaopin's search, they cost nothing)

Salary (a monthly CNY minimum / maximum or one of Zhaopin's bands), education, experience, job type (full-time,
part-time, internship, campus), company type (private, state-owned, foreign, joint venture...), company size, financing
stage, industries and job categories (by Chinese or English name or code), and sort order (relevance, newest, highest
salary).

#### More filters (checked on each job before it is delivered or charged)

Posted within N days / after a date, title must contain one of some words, title must contain the search keyword,
exclude words, exclude companies, only these companies, only jobs with a stated salary, direct employers only (no
agency postings), minimum recruiter responsiveness, at most N jobs per company, and a radius around a point (every job
carries Zhaopin's coordinates). A search whose jobs these filters mostly remove stops reading once further pages would
cost more than they return, and the status message says so.

### How to use

1. Type one or more **keywords** and **cities** (or paste Zhaopin links).
2. Set **Maximum jobs in total**.
3. Click **Start**, then download the results as JSON, CSV or Excel, or read them through the API.

```json
{
  "searchKeywords": ["数据分析", "产品经理"],
  "cities": ["上海", "北京"],
  "education": ["4"],
  "salaryMin": 15000,
  "maxItems": 400
}
```

Job links and numbers:

```json
{ "startUrls": ["https://www.zhaopin.com/jobdetail/CC534044020J40940808312.htm"], "jobIds": ["CC156263720J40889841707"] }
```

Every new job each day (schedule the run daily):

```json
{ "searchKeywords": ["Python"], "cities": ["深圳"], "monitorMode": true, "monitorName": "shenzhen-python", "maxItems": 200 }
```

### Output

One row per job. Fill rates measured on a 1,000-job run (`销售` in Beijing, 2026-11-14) unless marked:

| Group | Fields | Filled |
|---|---|---|
| Job | `jobId`, `positionId`, `title`, `jobUrl`, `applyUrl`, `jobStatus`, `description` (plain text) / `descriptionHtml` | 100% |
| Place | `city`, `cityEn`, `cityId`, `address`, `latitude`, `longitude` | 100% |
| | `district` 98.7%, `street` 84.2%, `tradingArea` 20.6% | |
| Salary | `salaryText` 100%; `salaryMin`, `salaryMax`, `salaryPeriod` (month, day, hour, piece), `currency` 98.8%; `salaryMonths` (·14薪 = 14, else 12), `salaryAnnualMin`, `salaryAnnualMax` 98.1%; `salaryNegotiable` (面议) | |
| Requirements | `education`, `educationEn`, `experience`, `experienceMin` 100%, `experienceMax` 57.9% (a range given), `employmentType`, `employmentTypeEn` 100% | |
| Category | `jobCategory`, `jobCategoryCode` 100%, `jobCategoryEn`, `jobCategoryParent` 99.8%, `workMode` 100% | |
| Tags | `skills` 99.0%, `tags` 99.9%, `benefits` 53.7%, `labels` (新发布, 代招岗位, 直招, 劳务派遣) 8.5%, `isNew`, `recruitCount` 62.6%, internship months / days a week / can become regular (internships) | |
| Dates | `postedAt` (UTC), `postedDate` and `publishTime` (China time), `daysSincePosted` 100%, `postedText` 11.1% | |
| Company | `companyName`, `companyShortName`, `companyId`, `companyUrl`, `companyLogo`, `companySize`, `companyIndustry`, `companyIndustries`, `companyOpenJobs` 100%; `companyType` / `companyTypeEn` 95.8%; `companyIndustryEn` 95.4%; `companyDescription` 93.0%; `companyFinancing` 84.8%; `companyVerifiedLicense` 98.6%; `companyReviewsCount` 66.1%; `companyInterviewsCount` 75.7%; `isAgencyPosting` / `clientCompany` (agency postings, 3.3%) | |
| Recruiter | `recruiterName`, `recruiterTitle`, `recruiterAvatar`, `recruiterVerified`, `recruiterLastOnlineAt` 100%; `recruiterBadges`, `recruiterResponsivenessScore` 85.5%; `recruiterOnlineState` 82.3%; `recruiterHighReplyRate` 40.3%; `recruiterRepliesToday` 27.0%; `recruiterExpectedReplyHours` 29.5% | |
| Run | `searchQuery`, `searchCity`, `searchUrl`, `position`, `detailsFetched`, `contentFingerprint`, `scrapedAt`; monitor mode adds `changeType`, `firstSeenAt`, `lastSeenAt` | |

**Recruiter responsiveness score (0-100)**, from Zhaopin's own badges: 高回复率 (high reply rate) +35; replies today
(今日回复N次) 50+ = +35, 10+ = +28, 1+ = +20; expected reply (N小时内回复可能性大) within 3 h +20, 6 h +16, 12 h +12, 24 h +6;
last active 刚刚 / 在线 +15, 今日 +12, 昨日 +8, 三日内 +4, older +2. Capped at 100; null when Zhaopin shows no badge.

#### Add-ons

| Add-on | Adds | Price | Measured (50 jobs, `软件工程师` in Shenzhen) |
|---|---|---|---|
| Include job details (on) | the job page's record: company description, financing, all industries, open jobs, licence check, apply link, benefits, bonus, recruiter last online and verified badge, review and interview counts | free | 100% of rows |
| Include company profile | `companyAddress`, `companyCity`, `companyAddresses`, `companyWebsite`, `companyBenefits`, `companyWorkHours`, `companyRestDays`, `companyOvertime`, `companyHonors`, `companyAffiliates`, `companyIsGroup` (read once per company) | free | address 100%, website 72%, benefits 88%, work hours 88% |
| Include business registration | `companyRegisteredName`, `companyCreditCode` (统一社会信用代码), `companyLegalRepresentative`, `companyRegisteredCapital`, `companyRegistrationDate`, `companyRegistrationStatus`, `companyLegalForm`, `companyRegisteredIndustry`, `companyRegisteredAddress`, `companyRegisteredRegion`, `companyRegistrationAuthority`, `companyBusinessPeriod`, `companyBusinessScope` (once per company) | free | 96-98% |
| Find employer emails | `employerEmail`, `employerEmails`, `employerEmailKind` (hiring / general / personal), `employerEmailDomain`, `employerEmailSourceUrl`, `emailLookupStatus` - from the website on the company's Zhaopin page (home page + up to 3 contact / about pages) | $0.0072 per employer found | 17 of 50 jobs; 14 had no website on Zhaopin, 14 websites did not answer, 4 had no email |
| Market summary rows | one row per search: monthly salary median, quartiles, 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 | $0.009 per summary | 1 row per search |

#### Example row (real, from the 1,000-job run; descriptions shortened here)

```json
{
  "rowType": "job",
  "jobId": "CCL1521565120J40875538913",
  "title": "销售助理跟单",
  "jobUrl": "https://www.zhaopin.com/jobdetail/CCL1521565120J40875538913.htm",
  "applyUrl": "https://campus1.zhaopin.com/Resume/CheckIntoApp?pid=CCL1521565120J40875538913",
  "companyName": "北京康盛和顺生物科技有限公司",
  "companyId": "CZL1521565120",
  "companySize": "20-99人",
  "companyType": "民营",
  "companyTypeEn": "Private",
  "companyIndustry": "医疗设备/器械/耗材",
  "companyIndustryEn": "Manufacture of Medical Equipment & Facilities",
  "companyIndustries": ["医疗设备/器械/耗材", "医药批发/零售"],
  "companyFinancing": "不需要融资",
  "companyOpenJobs": 17,
  "companyDescription": "北京康盛和顺生物科技有限公司是一家新成立、高起点的综合性生物科技企业，立足北京，聚焦大健康、医疗器械、智慧康养与居家健康服务领域。…",
  "companyVerifiedLicense": true,
  "city": "北京",
  "cityEn": "Beijing",
  "cityId": "530",
  "district": "朝阳",
  "street": "建外",
  "tradingArea": "建外大街",
  "address": "北京市-朝阳区-东三环中路39号一号楼702",
  "latitude": 39.905514971767154,
  "longitude": 116.45934838493014,
  "salaryText": "1.2-1.8万·14薪",
  "salaryMin": 12000,
  "salaryMax": 18000,
  "salaryPeriod": "month",
  "salaryMonths": 14,
  "salaryAnnualMin": 168000,
  "salaryAnnualMax": 252000,
  "currency": "CNY",
  "education": "中专/中技",
  "educationEn": "Secondary vocational",
  "experience": "1-3年",
  "experienceMin": 1,
  "experienceMax": 3,
  "employmentType": "全职",
  "employmentTypeEn": "Full-time",
  "jobCategory": "销售助理",
  "jobCategoryEn": "Sales Assistant",
  "jobCategoryParent": "行政",
  "skills": ["客户支持"],
  "tags": ["中专/中技", "1-3年", "客户支持", "重要节假日", "礼品赠送", "五险一金", "交通补助", "绩效奖金", "加班费", "工龄奖", "全勤奖", "话补"],
  "benefits": ["礼品赠送"],
  "recruitCount": 1,
  "jobStatus": "open",
  "postedAt": "2026-11-14T17:41:46.000Z",
  "postedDate": "2026-11-15",
  "publishTime": "2026-11-15 01:41:46",
  "description": "1客情维护 逢重要节假日以及客户生日进行客户感情维护，礼品赠送。\n2客户追踪 协助方案讲解 帮助客户办理业务，进行订单追踪。…",
  "recruiterName": "刘先生",
  "recruiterTitle": "人事经理",
  "recruiterVerified": true,
  "recruiterBadges": ["今日回复50+次", "高回复率", "12小时内回复可能性大"],
  "recruiterOnlineState": "昨日活跃",
  "recruiterLastOnlineAt": "2026-11-14T15:51:14.556Z",
  "recruiterRepliesToday": 50,
  "recruiterHighReplyRate": true,
  "recruiterExpectedReplyHours": 12,
  "recruiterResponsivenessScore": 90,
  "searchQuery": "销售",
  "searchCity": "北京",
  "position": 787,
  "detailsFetched": true
}
```

### Monitor mode

Switch on **Only new jobs** and schedule the run: each run returns only jobs that earlier runs of the same input did not
deliver (and jobs whose title, salary, address or description changed, marked `UPDATED`). The memory is kept per input
and per **Monitor name**; a poll reads Zhaopin newest first and stops once a page is mostly older than the previous run.
A poll with nothing new delivers nothing and charges nothing. Asking for an add-on later (for example job details after
running without them) delivers the jobs that lacked it once more, marked `DETAILS`. Alerts: a webhook, Slack, Discord,
Microsoft Teams, Telegram or ntfy message with the new jobs after each run.

### Pricing

Pay per event, no start fee:

| Event | Price |
|---|---|
| Job (a delivered job row, job details included) | **$0.89 per 1,000 jobs** ($0.00089 each) |
| Employer email (Find employer emails on, per employer whose email was found) | $0.0072 |
| Market summary (per summary row) | $0.009 |

Jobs removed by your filters, closed jobs, jobs an earlier monitor run delivered and searches that find nothing are not
charged. A **maximum cost per run** stops the run cleanly at that amount. Examples: 20 jobs = $0.0178; 1,000 jobs =
$0.89; 1,000 jobs with business registration = $0.89 (free add-on).

Speed measured on the platform (256 MB): 1,000 jobs with job details in 136-158 s; 150 jobs (3 keywords) in 6 s; one job
in 2 s.

### Limits

- Zhaopin serves at most 1,000 jobs per search; larger searches are split by district / city / province automatically.
- Zhaopin does not publish contact details in job descriptions (0 phone numbers or emails in 2,000 measured
  descriptions), so there are no description-contact fields; use Find employer emails for an employer inbox.
- The salary is Zhaopin's text parsed into numbers; a job paid by the day or hour has `salaryPeriod` `day` / `hour` and no
  annual figure. `面议` (negotiable) salaries have no numbers.
- `postedAt` is Zhaopin's publish time, which a refresh moves forward, so a job can show a recent date while its first
  posting is older.
- Company reviews: Zhaopin shows how many reviews and interview reports a company has; the review texts and an average
  score are not public.
- Not needed: a proxy. The actor reads Zhaopin's own public JSON directly and moves to Apify datacenter, then residential
  (China) proxies by itself if Zhaopin refuses a connection.

# Actor input Schema

## `searchKeywords` (type: `array`):

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).

## `cities` (type: `array`):

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.

## `startUrls` (type: `array`):

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.

## `jobIds` (type: `array`):

Zhaopin job numbers (the CC... code in a job link, e.g. CC534044020J40940808312). Each one is read from its job page's own record.

## `salaryMin` (type: `integer`):

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` (type: `integer`):

Jobs whose monthly salary range starts at or below this amount, e.g. 30000.

## `salaryBand` (type: `string`):

One of Zhaopin's monthly salary bands (CNY). Ignored when a minimum or maximum salary is set.

## `education` (type: `array`):

The education the job asks for (Zhaopin's own filter). API callers can also send names: "bachelor", "本科", "master".

## `experience` (type: `array`):

The work experience the job asks for (Zhaopin's own filter).

## `jobType` (type: `array`):

Full-time, part-time, internship or campus jobs (Zhaopin's own filter).

## `companyType` (type: `array`):

The employer's ownership (Zhaopin's own filter).

## `companySize` (type: `array`):

Number of employees (Zhaopin's own filter).

## `financingStage` (type: `array`):

The employer's financing stage (Zhaopin's own filter).

## `industries` (type: `array`):

Zhaopin industries by Chinese or English name or code, e.g. "软件/IT服务", "Automobile", "1600000000". All of them go into one search.

## `jobCategories` (type: `array`):

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.

## `sortBy` (type: `string`):

Zhaopin's own order. Monitor mode and a posted-within window always read newest first.

## `postedWithinDays` (type: `integer`):

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` (type: `string`):

Only jobs posted or refreshed on or after this date (China time), e.g. 2026-11-01.

## `titleKeywords` (type: `array`):

Keep a job only when its title contains one of these words, e.g. "经理", "Python".

## `titleMustMatchKeyword` (type: `boolean`):

Keep a job only when every word of its search keyword is in the title (Zhaopin also matches descriptions and related titles).

## `excludeKeywords` (type: `array`):

Leave out jobs whose title or company contains one of these words, e.g. "实习", "兼职", "外包".

## `excludeCompanies` (type: `array`):

Leave out jobs from companies whose name contains one of these.

## `companyNames` (type: `array`):

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.

## `onlyWithSalary` (type: `boolean`):

Leave out jobs whose salary is "面议" (negotiable).

## `excludeAgencyPostings` (type: `boolean`):

Leave out jobs posted by a recruitment agency for a client (Zhaopin's "代招岗位" label).

## `minRecruiterResponsiveness` (type: `integer`):

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` (type: `integer`):

At most this many jobs from one company (0 = no limit).

## `lat` (type: `number`):

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` (type: `number`):

E.g. 121.4737.

## `radiusKm` (type: `number`):

E.g. 5.

## `includeDetails` (type: `boolean`):

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.

## `includeCompanyProfile` (type: `boolean`):

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.

## `includeCompanyRegistration` (type: `boolean`):

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.

## `enrichEmails` (type: `boolean`):

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.

## `marketSummary` (type: `boolean`):

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.

## `descriptionFormat` (type: `string`):

How the job description is delivered.

## `descriptionMaxLength` (type: `integer`):

0 = the whole description.

## `excludeEmptyFields` (type: `boolean`):

Drop fields that are empty for a job (smaller rows; the columns then differ from row to row).

## `maxItems` (type: `integer`):

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.

## `maxItemsPerSearch` (type: `integer`):

At most this many jobs from each keyword x city search (0 = no limit).

## `maxPagesPerSearch` (type: `integer`):

Zhaopin pages of 20 jobs read per search (0 = all, up to 50).

## `splitLargeSearches` (type: `boolean`):

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).

## `monitorMode` (type: `boolean`):

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.

## `monitorName` (type: `string`):

Keeps separate memories for separate monitors with the same input (letters, digits and dashes).

## `includeUnchanged` (type: `boolean`):

Monitor mode: also deliver (and charge) jobs seen before and unchanged, marked changeType UNCHANGED.

## `emitBaseline` (type: `boolean`):

Monitor mode: off = the first run only records what exists now (nothing delivered or charged) and later runs return what is new.

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered and start again.

## `webhookUrl` (type: `string`):

After the run, POST a JSON message with the number of new jobs and the first ones (title, company, place, salary, link).

## `slackWebhookUrl` (type: `string`):

A Slack incoming-webhook URL for the same message.

## `discordWebhookUrl` (type: `string`):

A Discord webhook URL for the same message.

## `teamsWebhookUrl` (type: `string`):

A Teams incoming-webhook URL for the same message.

## `telegramToken` (type: `string`):

With a chat id: the same message to a Telegram chat.

## `telegramChatId` (type: `string`):

The chat that receives the message.

## `ntfyTopic` (type: `string`):

An ntfy.sh topic for a push notification.

## `notificationLimit` (type: `integer`):

How many jobs the message lists.

## `maxConcurrency` (type: `integer`):

Job and company records read at the same time.

## `proxyConfiguration` (type: `object`):

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.

## Actor input object example

```json
{
  "searchKeywords": [
    "数据分析"
  ],
  "cities": [
    "上海"
  ],
  "sortBy": "relevance",
  "titleMustMatchKeyword": false,
  "onlyWithSalary": false,
  "excludeAgencyPostings": false,
  "includeDetails": true,
  "includeCompanyProfile": false,
  "includeCompanyRegistration": false,
  "enrichEmails": false,
  "marketSummary": false,
  "descriptionFormat": "text",
  "excludeEmptyFields": false,
  "maxItems": 20,
  "splitLargeSearches": true,
  "monitorMode": false,
  "monitorName": "default",
  "includeUnchanged": false,
  "emitBaseline": true,
  "resetMonitor": false,
  "notificationLimit": 10,
  "maxConcurrency": 16,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per Zhaopin job: title, company, city, district, address with coordinates, salary as numbers (period, months, annual), education, experience, job type and category, skills, labels, full description, contacts written in it, recruiter and reply signals; job details, company profile, business registration and employer email when switched on; one market summary row per search when switched on.

## `summary` (type: `string`):

Per-search counts (pages read, delivered, status), filters, record reads and egress. Written when a search failed or on runs of 1,000+ jobs; every run logs it.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchKeywords": [
        "数据分析"
    ],
    "cities": [
        "上海"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/zhaopin-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchKeywords": ["数据分析"],
    "cities": ["上海"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/zhaopin-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchKeywords": [
    "数据分析"
  ],
  "cities": [
    "上海"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call topapi/zhaopin-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/zhaopin-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sFPTdzdH4emsORGB3/builds/jTJfdzStexoIo0edO/openapi.json
