Liepin China Jobs Scraper: White-Collar Recruitment Data

Get live white-collar Chinese job listings (including structured monthly salaries, bonus months, experience, and company profiles) ready for your spreadsheet in under 60 seconds. Get vacancy titles, standardized CNY salary metrics, prefecture locations, candidate degree requirements, and company types for any keyword across China.

---

What can you do with it?

• I am an international recruitment consultant sourcing bilingual tech talent, executives, and white-collar job openings across China (such as Beijing, Shanghai, and Shenzhen) to backfill our headhunting pipelines.
• I am a compensation and labor market researcher tracking monthly base salaries and annual bonus month structures (e.g., 15k-20k·13薪) in major Chinese city tiers to compile competitive compensation reports.
• I am a B2B lead generator extracting hiring companies, corporate registration types, and headcount sizes to build targeted sales prospecting databases.

---

How to use it

Store Quick Start

1. Create a free Apify account.
2. Open the Liepin China Jobs Scraper in the Apify Store.
3. Select your target city (e.g. Beijing, Shanghai, Shenzhen) or "Featured"Snapshots.
4. Enter an optional keyword (e.g. python, 产品经理, AI).
5. Click Start and download the dataset as JSON, CSV, or Excel.

API Quick Start

For developers, you can trigger a run programmatically with a single request:

curl --request POST \
  --url "https://api.apify.com/v2/acts/getascraper~liepin-scraper/runs?token=YOUR_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "keyword": "python",
    "city": "020",
    "maxItems": 100
  }'

---

Input

Field	Type	Default	Description
scrapeMode	string	home	Choose how to discover jobs: home grabs today's featured jobs (fastest), search filters by keyword.
keyword	string	python	Search keyword (e.g., AI, 产品经理, Golang). Ignored when scrapeMode is home.
city	string	010	Filter by city codes (Beijing 010, Shanghai 020, Guangzhou 030, Shenzhen 040).
pagesPerQuery	integer	3	How many search result pages to walk through (up to 40 jobs per page).
includeJobDetail	boolean	true	Visit each job's detailed page to extract the full job description.
outputFormat	string	flat	flat returns one row per job. normalized splits jobs and companies into separate tables.
maxItems	integer	50	Maximum number of job records to extract.
proxyConfiguration	object	{"useApifyProxy": true}	Premium rotating residential proxies are recommended for sustained search runs.

---

Output

Each row represents a single job listing from Liepin.

{
  "sku": "1983197685",
  "productId": "1983197685",
  "url": "https://www.liepin.com/job/1983197685.shtml",
  "title": "艺术总监",
  "companyName": "上海博盟文化发展有限公司",
  "salaryRawText": "15-18k·13薪",
  "minSalaryMonthlyCny": 15000,
  "maxSalaryMonthlyCny": 18000,
  "bonusMonths": 13,
  "annualEstimateCny": 214500,
  "salaryDisclosed": true,
  "currency": "CNY",
  "degreeRequired": "Bachelor's",
  "companyType": "Private Enterprise",
  "experienceRequired": "3-5 Years",
  "city": "上海",
  "province": "上海",
  "region": "上海",
  "address": "上海-航华",
  "scrapedAt": "2026-06-10T13:00:00.000Z"
}

Field Reference

Field	Type	Description
sku	string	Unique identifier of the job vacancy.
url	string	Direct public job detail link.
title	string	Job title.
minSalaryMonthlyCny	number	Standardized minimum monthly salary in Yuan (CNY).
maxSalaryMonthlyCny	number	Standardized maximum monthly salary in Yuan (CNY).
bonusMonths	number	Number of salary payment months per year (e.g., 13薪 = 13).
annualEstimateCny	number	Computed estimated annual salary in Yuan (CNY).
degreeRequired	string	Standardized degree requirements (Bachelor's, Master's, PhD, Any Degree).
companyType	string	Standardized company type (Private Enterprise, State-Owned, Foreign-Owned).
experienceRequired	string	Standardized required experience band (1-3 Years, 3-5 Years, etc.).

---

Pricing & Cost

Pricing is pay-per-result and is billed per row successfully saved to your dataset. Empty runs cost absolutely nothing.

• Rate: $1.99 per 1,000 results ($0.00199 per result).
• 100 listings typically cost $0.20.
• 1,000 listings cost exactly $1.99.
• 10,000 listings cost exactly $19.90.
• No fixed monthly subscriptions or hidden maintenance fees.

---

Tips & Best Practices

• Predictable URL Extraction. Liepin job detail URLs always follow a strict, predictable format https://www.liepin.com/job/1{jobid}.shtml derived from listing cards. The Actor extracts and queues details seamlessly with zero DOM fragility.
• Bilingual Translations Natively. The Actor automatically translates and maps complex Chinese recruitment specifications (degrees like 本科 or 硕士, company types like 民营 or 上市公司) into standardized B2B English fields.
• Disable detail fetches for fast sweeps. Turn off the includeJobDetail parameter to skip detailed pages, cutting execution speed by 10x and saving proxy bandwidth.

---

FAQ

Does it get blocked by Liepin?

No. The scraper natively supports premium, rotating Residential Proxies with Singapore (SG), Hong Kong (HK), or Japan (JP) country codes. This ensures ideal peering with Chinese networks and completely avoids geoblocking firewalls.

Does it extract private candidate or recruiter contact details?

No. To protect user privacy and avoid verification blocks, the scraper does not extract private recruiters, personal contact details, or candidate accounts. It strictly extracts public vacancies, salaries, degree requirements, and corporate profiles.

How fresh is the data?

Extremely fresh. The scraper executes live HTTP requests on every query, retrieving the absolute latest vacancies posted on Liepin in real-time.

Are all categories supported?

Yes. The scraper supports all major white-collar and professional occupations including IT, Web Engineers, Consulting, Sales, Marketing, and Project Management.

---

Target SEO Keywords

• Liepin API
• scrape Liepin
• China white-collar jobs data
• Beijing executive recruiter scraper
• Chinese recruitment API

---

Disclaimers & Support

• Disclaimer: This Actor retrieves publicly available job postings on Liepin. Make sure your usage complies with Liepin's terms of service and applicable laws.
• Support: Open an issue from the Actor page in the Apify Console for bug reports or feature requests.