Liepin Scraper 猎聘 — China Jobs, Salaries, Companies & Recruiters

Scrape Liepin (liepin.com, 猎聘), China's leading white-collar and headhunter job board, by keyword and city. Get the job title, parsed salary range (including the number of salary months), city and district, required experience and education, the hiring company's profile, and the recruiter or headhunter behind each job. No proxy setup, no login.

Built for recruiters, headhunting firms, HR-tech products and China labour-market analysts who need Liepin data as structured JSON.

Why use this scraper

• Salaries as numbers. 40-70k·14薪 becomes min 40000, max 70000, months 14, period month — ready to sort, filter and annualise.
• The recruiter, not just the job. Every row carries the recruiter's name, title and last-active status — the contact layer that makes Liepin different from generic job boards.
• Company profile on every row. Company name, industry, size and funding stage come with each job; turn on full details to add the company address and headcount.
• Keyword × city grid. Search any keyword across as many cities as you like; each pair is paged automatically.
• Monitor mode that only bills for change. Deliver (and pay for) only jobs that are new or updated since the last run.
• No setup. No proxies, cookies or keys to configure.

Overview

Liepin is one of China's largest mid-to-senior job platforms, used heavily by headhunters. This actor searches Liepin for each keyword in each city you choose, reads up to 10 result pages per search, and returns one normalized row per job. Optionally it opens each job page for the full description.

Supported inputs

Input	What it does
searchTerms	Keywords in Chinese or English, e.g. python, 销售, 产品经理.
cities	Chinese names (北京), pinyin (beijing) or Liepin city codes (010). Empty = nationwide.
pagesPerQuery	Result pages (≈40 jobs each) per keyword × city, up to 10.
includeJobDetail	Also open each job page for the full description, company address and headcount.
startUrls	Paste Liepin search URLs or job URLs — auto-routed.
onlyChanged	Monitor mode: deliver only new or changed jobs.
maxItems	Hard cap on jobs collected and billed.
maxConcurrency	Parallel job-page requests when full details are on.

Supported city names out of the box: 全国 (nationwide), 北京, 上海, 天津, 重庆, 广州, 深圳, 南京, 苏州, 杭州, 武汉, 西安, 成都 — any other Liepin city works by its code.

Use cases

• Headhunting & sourcing. Map which companies and recruiters are hiring for a role, city by city.
• Salary benchmarking. Compare monthly ranges and salary-month counts across cities, seniority and industries.
• Competitive hiring intel. Track which companies are expanding teams and at what level.
• Job-alert products. Feed fresh postings into alerts with monitor mode.

How it works

1. Each keyword is searched in each chosen city; pasted URLs are auto-classified.
2. Result pages are read one after another, up to pagesPerQuery (Liepin serves at most 10 per search).
3. Each job is normalized into a flat row with parsed salary, company and recruiter.
4. With full details on, each job page is opened for the description and company address.
5. In monitor mode, unchanged jobs are skipped before billing.

Output sample

{
  "type": "job",
  "source": "liepin.com",
  "jobId": "85675269",
  "url": "https://www.liepin.com/job/1985675269.shtml",
  "title": "海外增长技术专家",
  "salary": { "raw": "40-70k·14薪", "min": 40000, "max": 70000, "months": 14, "currency": "CNY", "period": "month", "negotiable": false },
  "city": "北京",
  "district": "昌平区",
  "experience": "5-10年",
  "education": "统招本科",
  "refreshedAt": "2026-09-23T17:40:29+08:00",
  "company": { "name": "好未来", "industry": "教育", "scale": "10000人以上", "stage": "已上市" },
  "recruiter": { "name": "唐女士", "title": "招聘顾问", "lastActive": "2小时前在线" },
  "description": null,
  "searchKeyword": "python",
  "searchCity": "北京"
}

description, headcount and company.address are filled when includeJobDetail is on.

Key output fields

jobId, title, salary (raw / min / max / months / period / negotiable), city, district, experience, education, labels, refreshedAt, featured, company (name / industry / scale / stage / address), recruiter (name / title / lastActive), description, url, searchKeyword, searchCity.

Pricing

Pay-per-event: a small per-run start fee plus a per-job charge. Monitor mode only bills for jobs that are new or updated.

FAQ

Do I need proxies? No.

Why at most 10 pages per search? Liepin itself serves up to 10 result pages per search. To collect more, add cities (each keyword × city pair is its own search).

Is the recruiter's phone or email included? No. Liepin does not publish recruiter contact details on job listings; you get the recruiter's name, title and activity status.

Can I search in English? Yes, English keywords work; results are in Chinese as published on Liepin.

For AI agents & LLM apps

Every row is flat, typed JSON with numeric salary fields and a stable schema, ready for a retrieval pipeline, an agent tool call, or a spreadsheet. Point an MCP-enabled agent at this actor to pull live Chinese job-market data on demand.

⚠️ Disclaimer

This actor collects only publicly available information from liepin.com. Use the data in compliance with applicable laws (including China's PIPL where relevant) and the source site's terms. You are responsible for how you use the scraped data, including any personal data.

SEO Keywords

Liepin scraper, 猎聘 scraper, liepin.com scraper, China jobs API, Chinese job board scraper, China salary data, headhunter jobs China, recruiter data China, 招聘数据, 猎聘职位抓取, China white-collar jobs, job postings China export.