Com APIyz.chsi.com.cn ↗
Access Chinese graduate admissions data: search doctoral programs, institutions, major categories, and retrieve admission brochures from yz.chsi.com.cn.
What is the Com API?
This API exposes 7 endpoints covering China's Graduate Admissions Information Network (yz.chsi.com.cn), including program search, institution lookup, and admission brochure retrieval. With search_doctoral_programs you can query programs by major name keyword and get back paginated institution results with province codes, while get_brochure_detail returns full plain-text and HTML content of official enrollment brochures. Major taxonomy is covered through a two-step discovery flow via list_major_categories and list_majors.
curl -X GET 'https://api.parse.bot/scraper/3760c3fd-ad38-4662-918b-e3c0017abd23/search_doctoral_programs?xxfs=1&zymc=%E8%AE%A1%E7%AE%97%E6%9C%BA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for graduate or doctoral programs by major name keyword. Returns a paginated list of institutions offering matching programs with their codes, names, and provinces. Each result identifies the institution and whether it has a graduate school.
| Param | Type | Description |
|---|---|---|
| xxfs | string | Study mode |
| zymc | string | Major name keyword to search in Chinese (e.g., '生物', '药学', '计算机') |
{
"type": "object",
"fields": {
"list": "array of program result objects with dwdm, dwmc, ssmc, yjsy",
"curPage": "integer current page number",
"totalPage": "integer total number of pages",
"totalCount": "integer total number of matching institutions"
},
"sample": {
"data": {
"list": [
{
"dwdm": "10002",
"dwmc": "中国人民大学",
"ssmc": "北京市",
"yjsy": "1"
}
],
"size": 20,
"curPage": 1,
"pageCount": 20,
"totalPage": 5,
"totalCount": 82,
"nextPageAvailable": true
},
"status": "success"
}
}About the Com API
Institution and Program Search
search_doctoral_programs accepts a Chinese major name keyword (zymc, e.g. '计算机') and an optional study mode filter (xxfs), returning paginated results with institution code (dwdm), institution name (dwmc), province name (ssmc), and a flag indicating graduate school status (yjsy). Response fields curPage, totalPage, and totalCount support full pagination. search_institutions provides a complementary institution-level search by name keyword (yxmc) or province code (ssdm), paginated via a numeric start offset in increments of 20, returning each institution's display name and internal schId.
School Info and Brochure Access
get_school_info resolves an institution's internal schId when you already know its standard five-digit code (dwdm) and Chinese name (dwmc). Both parameters are required. The response also returns a profile url for the institution. Once you have a schId, pass it to get_brochure_list to retrieve all published admission brochures (招生简章) for that school — each result includes a title, detail page url, and publication date. Feed any brochure URL into get_brochure_detail to receive the full brochure as both plain content and html_content.
Major Taxonomy
Two endpoints map the site's major knowledge base (专业知识库). list_major_categories returns a tree of subject categories (门类) for a given degree type, each with its nested first-level disciplines (一级学科) and their 6-digit codes. Pass any of those discipline codes to list_majors to get all majors under that discipline, with each major's Chinese name, 6-digit code (专业代码), associated degree_type, and detail_url on the source site. This two-step flow covers the complete official major classification system used for graduate admissions in China.
The Com API is a managed, monitored endpoint for yz.chsi.com.cn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yz.chsi.com.cn changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yz.chsi.com.cn API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a program comparison tool that queries
search_doctoral_programsfor a given major keyword and maps results by province usingssmc. - Aggregate admission brochures across target institutions using
get_brochure_listandget_brochure_detailto extract enrollment requirements and deadlines. - Populate an institution directory filtered by province by calling
search_institutionswith assdmprovince code. - Resolve standard institution codes (
dwdm) to internalschIdvalues viaget_school_infoto automate brochure retrieval pipelines. - Build a structured index of China's graduate major taxonomy by iterating
list_major_categoriesandlist_majorsacross all degree types. - Track which institutions offer programs in a specific discipline by combining
list_majorsdiscipline codes withsearch_doctoral_programskeyword searches.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does yz.chsi.com.cn have an official developer API?+
What does `get_brochure_detail` return, and how do I get the URL to pass into it?+
content (plain text of the brochure) and html_content (the raw HTML). The URL must come from the url field in a brochure object returned by get_brochure_list, which itself requires a sch_id obtained from either search_institutions or get_school_info.How does pagination work for `search_doctoral_programs` versus `search_institutions`?+
search_doctoral_programs uses a page-based model: the response includes curPage, totalPage, and totalCount. search_institutions uses an offset model: pass a start integer incrementing by 20 to step through result pages. The two endpoints have different pagination conventions and cannot be used interchangeably.Does the API return individual program details such as tuition, supervisor lists, or application deadlines?+
get_brochure_detail. Structured per-program fields like tuition fees or supervisor rosters are not exposed as discrete response fields. You can fork this API on Parse and revise it to add an endpoint targeting that structured data.