zhipin.com APIzhipin.com ↗
Access job listings, job details, and recommended jobs from BOSS直聘 (zhipin.com) via 3 endpoints. Returns salary, city, experience, degree, and company data.
// select an endpoint above
About the zhipin.com API
This API exposes 3 endpoints for retrieving job data from BOSS直聘 (zhipin.com), China's major direct-hire job platform. The get_recommend_jobs endpoint returns up to 81 recommended and trending listings across multiple categories, while search_jobs lets you query by keyword and city code, and get_job_detail retrieves the full job description for a specific listing. Response objects include salary, experience requirements, degree requirements, city, and company details.
Endpoints and Data Coverage
The API provides three endpoints. get_recommend_jobs returns up to 81 jobs from the platform's homepage, optionally filtered by city using numeric city codes (e.g., 101010100 for Beijing, 101020100 for Shanghai, 101280100 for Guangzhou, or 100010000 for all cities). Each job object in the jobList array includes fields such as encryptJobId, jobName, salaryDesc, cityName, jobExperience, jobDegree, jobLabels, brandName, and related brand/company metadata. The totalCount field indicates how many jobs were returned.
Searching and Filtering Jobs
search_jobs accepts a query string (e.g., IT技术总监), a city code, and a page number for pagination. It returns a jobList array and a hasMore boolean indicating whether additional pages exist. Note that salary information in search results is hidden unless a valid __zp_stoken__ authentication token is supplied via the zp_stoken parameter. Without this token, most other job metadata still returns, but salaryDesc fields may be absent or masked.
Job Detail Retrieval
get_job_detail fetches the full description of a specific job. It requires three identifiers sourced from search results: lid (LID token), security_id, and encrypt_job_id. The response contains a jobInfo object with jobName, salaryDesc, and postDescription — the full plain-text job description including responsibilities, requirements, and any recruiter-provided content.
City Codes and Scope
City filtering relies on numeric codes used by zhipin.com. The documented codes cover major Chinese cities: Beijing (101010100), Shanghai (101020100), Guangzhou (101280100), and the catch-all 100010000 for all cities. Jobs from cities not explicitly listed in the supported values may still appear in results when using the all-cities code.
- Aggregate trending job listings from China's direct-hire market by city for a job board or newsletter
- Track demand for specific roles (e.g., IT directors, engineers) by querying
search_jobswith targeted keywords - Compare experience and degree requirements across job categories using
jobExperienceandjobDegreefields - Build salary benchmarking datasets by collecting
salaryDescvalues from authenticatedget_job_detailresponses - Monitor which companies (
brandName) are actively hiring in a given city usingget_recommend_jobswith city codes - Feed structured Chinese job data into an LLM-based career assistant using full
postDescriptioncontent fromget_job_detail - Research hiring trends across Beijing, Shanghai, and Guangzhou by running parallel queries with different city codes
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BOSS直聘 (zhipin.com) have an official developer API?+
What does the `search_jobs` endpoint return without a `zp_stoken` token?+
zp_stoken value, most job metadata — including job name, city, experience level, degree requirement, and company name — is still returned. Salary information (salaryDesc) is hidden or absent when authentication is not provided. Supplying a valid __zp_stoken__ cookie value via the zp_stoken parameter exposes salary data in results.How does pagination work in `search_jobs`, and how many results are returned per page?+
search_jobs endpoint accepts a page integer parameter and returns a hasMore boolean in the response. When hasMore is true, additional pages of results are available. The exact number of jobs per page follows zhipin.com's default pagination, typically around 10–20 listings per request.Does the API return job application data, recruiter contact details, or candidate profiles?+
Is there a limitation on which cities can be filtered in `get_recommend_jobs`?+
get_recommend_jobs, though they may appear in results when using the all-cities code. The search_jobs endpoint accepts any city code string, so filtering by additional cities is possible there. You can fork the API on Parse and revise it to extend city code support for get_recommend_jobs.