---
name: gaokao-admission-research
description: "面向高考志愿填报、院校库、专业库、分数线、招生计划和录取概率分析的公开 API 组合。适用于志愿填报工具、教育数据平台、院校信息查询。"
compatibility: "需要访问 GuGuData HTTPS API；执行接口前需开通对应服务并安全配置 AppKey。"
metadata:
  author: "GuGuData"
  version: "1.0.0"
  homepage: "https://www.gugudata.com/skills/gaokao-admission-research"
---

# 高考志愿与教育数据 Skill

面向高考志愿填报、院校库、专业库、分数线、招生计划和录取概率分析的公开 API 组合。

## 业务场景

用于高考志愿填报、教育数据平台、院校库查询、专业库查询、招生计划分析和录取概率解释。适合把院校、专业、招生计划、分数线、一分一段、院校评分和智能问答组合成完整的志愿填报数据链路。

- 数据范围：覆盖院校基础信息、专业信息、招生计划、院校录取线、专业录取线、省控线、一分一段、模型预测、院校评分、高考问答以及部分职教、海外院校和测评扩展数据。
- 关键数据维度：院校维度：学校名称、地区、层次、类型、办学属性、院校代码和综合评分；专业维度：专业名称、专业门类、院校开设情况和专业录取参考；招生维度：年份、省份、批次、科类、选科、计划人数、招生代码和专业组信息；录取维度：最低分、最低位次、省控线、一分一段区间、预测概率和历史趋势。

## 何时使用

- 按省份、年份、批次、科类或选科条件筛选院校和专业。
- 对比分数线、位次、招生计划和录取概率，支撑冲稳保排序。
- 为院校详情页、专业详情页、志愿推荐页和问答助手提供数据依据。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。
- 用户要求确定录取结果或替代考试院、学校官方信息时，不应只依赖 Skill 输出。

## 用户需要提供的信息

- 考生省份、目标年份、科类或选科、批次、分数和位次。
- 目标院校、院校所在地、专业名称、院校层次或冲稳保偏好。
- 需要对比的历史年份范围，以及是否需要录取概率、院校评分或问答解释。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先查询院校、专业和省份基础数据。
2. 再按年份、省份、批次、选科或科类查询分数线与招生计划。
3. 需要排序或推荐时，结合一分一段、录取概率和高校评分接口做结果解释。

## 参数传递关系

- 先用院校基础信息接口按 `keywords`、地区、院校类型或层次查询院校，并保留返回的 `SchoolUUID`、院校名称、院校所在地和院校代码。
- `SchoolUUID` 可继续传给招生计划、分数线、录取概率或院校评分相关接口；院校名称可作为模糊查询和展示字段。
- `year`、`provinceName`、`subjectSelection`、`batchName` 必须在招生计划、分数线、一分一段和预测接口之间保持同一口径。
- 用户提供 `score` 后，先用一分一段接口换算或校验 `rank`；如果用户已经提供位次，应优先使用真实位次。
- 专业偏好先用专业库或招生计划明细确认标准专业名称，再传给专业分数线或专业级录取预测。

## 典型任务模板

- 院校推荐：输入省份、年份、科类/选科、批次、分数和位次；输出冲稳保分组、历史分数线、招生计划和录取概率说明。
- 院校详情：输入院校名称或 `SchoolUUID`；输出院校基础信息、开设专业、招生计划、近年录取线和院校评分。
- 专业对比：输入专业名称、目标省份、年份和批次；输出开设院校、计划人数、专业录取线和风险提示。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 全国大学高校基础信息

- 高校资料与院系专业查询
- 业务角色：院校基础库
- 调用阶段：基础数据
- 接口地址：`GET https://api.gugudata.com/location/college`
- 产出用途：用于查询全国大学高校基础信息，是高考业务的院校主索引。
- 参数来源：`SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
- [查看接口详情](https://www.gugudata.com/api/details/college) · [读取接口 Markdown](https://www.gugudata.com/api/details/college/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `schooluuid` | 否 | `string` | - | 学校唯一标识；与 uuid 别名兼容，值冲突明确失败。 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `uuid` | 否 | `string` | - | 咕咕数据平台高校唯一 ID，可按响应字段 SchoolUUID 精确查询高校基础信息 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `keywords` | 否 | `string` | - | 搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `pageindex` | 否 | `integer` | 1 | 页码，第几页数据，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 每页数据量，参数最大值为 20，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `keywordstrict` | 否 | `string` | false | 控制 keywords 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `collegecategory` | 否 | `string` | - | 院校类别筛选，默认值为空，不进行筛选。当前可选值：中职院校、体育类、其他、其它、军事类、农林类、医药类、师范类、政法类、民族类、理工类、综合类、艺术类、语言类、财经类。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `collegetype` | 否 | `string` | - | 院校类型筛选，默认值为空，不进行筛选。当前可选值：专科（高职）、中外合作办学、中等专业学校、其它、普通本科、本科、独立学院。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `is985` | 否 | `string` | - | 是否为 985 院校，需要参与查询则传参为：true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `is211` | 否 | `string` | - | 是否为 211 院校，需要参与查询则传参为：true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/college/llm.md

### 全国大学高校专业数据

- 专业层级、课程与就业资料
- 业务角色：专业基础库
- 调用阶段：基础数据
- 接口地址：`GET https://api.gugudata.com/metadata/ceemajor`
- 产出用途：用于查询高校专业和专业分类，支撑专业筛选与详情展示。
- 参数来源：院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；分页参数由调用方控制，用于分批读取结果
- [查看接口详情](https://www.gugudata.com/api/details/ceemajor) · [读取接口 Markdown](https://www.gugudata.com/api/details/ceemajor/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `code` | 否 | `string` | 无 | 既有专业代码精确筛选参数；与 keywords 同时提供时共同限定结果。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `keywords` | 否 | `string` | 无 | 专业检索关键词，包含匹配专业名称、学科、专业简介或课程名称；为空时返回分页专业列表。 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `pageIndex` | 否 | `integer` | 1 | 页码，第几页数据，第一页从 1 开始 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 10 | 每页数据量，参数最大值为 20 | 分页参数由调用方控制，用于分批读取结果 |

### 历年高校招生计划数据

- 历年高校招生计划与选科要求
- 业务角色：招生计划
- 调用阶段：计划核验
- 接口地址：`GET https://api.gugudata.com/metadata/college-enrollment-plan`
- 产出用途：用于查询历年高校招生计划、院校招生代码和计划专业信息。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；省份参数需要区分考生所在省份、招生省份和院校所在地；分页参数由调用方控制，用于分批读取结果；`SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得
- 可参考的相关能力：历年高校招生计划数据-查询参数枚举、历年高校招生计划数据-院校招生代码查询
- [查看接口详情](https://www.gugudata.com/api/details/collegeenrollmentplan) · [读取接口 Markdown](https://www.gugudata.com/api/details/collegeenrollmentplan/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `string` | 无 | 查询年份。当前可选值：2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `provincename` | 是 | `string` | - | 招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。必填，请填写考生报考的省份，例如江苏。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `pageIndex` | 是 | `integer` | 无 | 分页页码，从 1 开始。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 是 | `integer` | 无 | 每页数量，取值范围为 1~100。 | 分页参数由调用方控制，用于分批读取结果 |
| `schooluuid` | 否 | `string` | - | 高校唯一标识，适合与高校基础数据、分数线接口进行关联。 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `schoolname` | 否 | `string` | - | 高校名称关键词；与 schooluuid 同时传入时需同时满足相应筛选条件。 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `collegemajorname` | 否 | `string` | - | 招生专业名称关键词；可与高校、年份、招生省份、科类和批次条件组合筛选。 | 专业名称来自用户偏好、专业库或招生计划明细 |
| `batchName` | 否 | `string` | - | 录取批次筛选。当前全部可选值（共 117 项）：一本预科、专科批、专科批F段、专科提前批、专科提前批E段、专项计划本科、国家专项批、国家专项计划(本一)、国家专项计划(本二)、国家专项计划提前批(本一)、国家专项计划本科批、提前一批本科、提前专项批、提前二批本科、提前批、提前批A段、提前批B段、提前本科批、普通类一段、普通类二段、普通类平行录取、普通类提前批、本科一批、本科一批A1段、本科一批A段、本科一批B段、本科一段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二批、本科二批A段、本科二批B段、本科二批C段、本科二批及预科、本科二段、本科批、本科批A段、本科批B段、本科批C段、本科批（民委专项）、本科提前批、本科提前批A段、本科提前批B段、本科提前批C段、艺术类专科批、艺术类本科批、零志愿批次、高校专项批、高校专项计划批次、高校专项计划本一批、高校专项计划本科批、专科提前批A段、专科提前批B段、专科特殊类型批次K段、体育类本科提前批B段、国家专项计划提前批(本二)、艺术类本科提前批B段、本科提前批C、艺术类本科提前批C段、国家专项计划批、国家及地方专项、南疆单列、对口援疆计划本科一批次、体育类本科批、公安司法军士类专科批次N段、国家优师专项、地方专项计划本科批、体育类专科批、提前二批高职(专科)、国家及地方专项、南疆单列、对口援疆计划本科二批次、体育类本科提前批、艺术类本科提前批、高职高专提前批、平行录取二段、乡村振兴专项计划、区域教育均衡发展专项、地方专项计划、省级公费师范生、高校专项计划提前批、平行录取一段、提前一批高职(专科)、国家及地方专项、南疆单列、对口援疆计划本科一批、提前录取本科一批、提前批A类、提前批B类、提前批艺体类本科、本科批A段（国家专项）、本科批（特殊类型）、本科批（高校专项）、本科提前批-国家专项、本科提前批D段、本科提前批（国家专项）、本科预科班批、民航飞行技术批、特殊类型批、特殊类型招生批、综合评价批、高校专项计划批、高校农村专项计划、高职专科提前批、高职专科提前批E段、提前录取本科二批、地方农村专项计划批次、综合评价批次、定向计划批、提前批艺体类专科、地方专项计划批、地方农村专项计划、专科提前批C段、提前录取军校批、区域专项计划批、本科批A段（地方专项）、本科批（区域教育均衡发展专项）、本科批（原加授少数民族语文）、本科批（原少数民族语言授课为主）、本科批（预科）、本科提前批-高校专项、本科提前批（高校专项）。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related'>历年高校招生计划数据-查询参数枚举</a>（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.batchName。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `type` | 否 | `string` | - | 科类/选科类型筛选。当前全部可选值（共 15 项）：历史类、文科、物理类、理科、综合、艺术文、艺术类、体育类（历史）、体育类（物理）、艺术类（历史）、艺术类（物理）、体育类、体育文、体育理、艺术理。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related'>历年高校招生计划数据-查询参数枚举</a>（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.type。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `classone` | 否 | `string` | - | 专业门类/一级分类筛选。当前全部可选值（共 33 项）：--、交通运输大类、公共管理与服务大类、公安与司法大类、农学、农林牧渔大类、医学、医药卫生大类、历史学、哲学、土木建筑大类、工学、教育与体育大类、教育学、文化艺术大类、文学、新闻传播大类、旅游大类、水利大类、法学、理学、生物与化工大类、电子与信息大类、管理学、经济学、能源动力与材料大类、艺术学、装备制造大类、财经商贸大类、资源环境与安全大类、轻工纺织大类、食品药品与粮食大类、交叉学科。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related'>历年高校招生计划数据-查询参数枚举</a>（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.classone。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/collegeenrollmentplan/llm.md

### 历年高考一分一段数据

- 高考分数段与位次对照
- 业务角色：一分一段
- 调用阶段：位次分析
- 接口地址：`GET https://api.gugudata.com/metadata/ceeline/one-score-one-section`
- 产出用途：用于把分数转换成位次区间，支撑冲稳保分析。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举；`score` 为用户高考分数，用于一分一段和录取概率分析
- 可参考的相关能力：历年高考一分一段数据-查询参数枚举、历年高考一分一段数据-科目类型枚举（兼容路由）
- [查看接口详情](https://www.gugudata.com/api/details/ceeline-one-score-one-section) · [读取接口 Markdown](https://www.gugudata.com/api/details/ceeline-one-score-one-section/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `string` | 无 | 查询年份。当前可选值：2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `provinceName` | 是 | `string` | 无 | 招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `subjectSelection` | 是 | `string` | 无 | 科目选择类型筛选。当前全部可选值（共 5 项）：综合、历史类、物理类、文科、理科。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceeline-one-score-one-section#anchor_related'>历年高考一分一段数据-查询参数枚举</a>（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.subjectSelection。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `score` | 否 | `string` | 无 | 按高考分数查询对应分数段和位次，支持整数或小数；为空时返回分页列表。 | `score` 为用户高考分数，用于一分一段和录取概率分析 |
| `pageIndex` | 否 | `integer` | 1 | 分页参数，第几页，默认值为1 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 10 | 分页参数，每页条数，取值范围在 1 ~ 100 之间（含） | 分页参数由调用方控制，用于分批读取结果 |
| `isArtLine` | 否 | `boolean` | false | 是否查询艺术类一分一段数据；true 表示查询艺术类，false 或不传表示查询普通类。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `artLineType` | 否 | `string` | 统考成绩排名 | 艺术类分数线类型，isArtLine=true 时可传。当前全部可选值（共 3 项）：统考成绩排名、综合成绩排名、文化成绩排名。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceeline-one-score-one-section#anchor_related'>历年高考一分一段数据-查询参数枚举</a>（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.artLineType。 | 科类或选科来自用户所在省份当年的可选枚举 |

### 历年高考高校录取分数线

- 高校历年录取分数与位次
- 业务角色：院校录取线
- 调用阶段：录取参考
- 接口地址：`GET https://api.gugudata.com/metadata/ceecollegeline`
- 产出用途：用于查询高校历年录取分数线，适合做院校维度对比。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
- 可参考的相关能力：历年高考高校录取分数线-查询参数枚举
- [查看接口详情](https://www.gugudata.com/api/details/ceecollegeline) · [读取接口 Markdown](https://www.gugudata.com/api/details/ceecollegeline/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `integer` | 无 | 查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `keyword` | 是 | `string` | 无 | 录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME 时传招生省份；searchtype=COLLEGENAME 时传高校名称。招生省份当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageindex` | 是 | `integer` | 无 | 分页参数，第几页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 是 | `integer` | 无 | 分页参数，每页总条数，取值范围在 1 ~ 20 之间（含） | 分页参数由调用方控制，用于分批读取结果 |
| `searchtype` | 是 | `string` | 无 | 查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME | 科类或选科来自用户所在省份当年的可选枚举 |
| `schooluuid` | 否 | `string` | - | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 SchoolUUID 进行唯一匹配 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `batchname` | 否 | `string` | - | 录取批次筛选，可使用英文逗号分隔传递多个值。当前全部可选值（共 74 项）：专科批、本科批、本科批（民委专项）、本科提前批、本科提前批A段、艺术类专科批、艺术类本科批、专科提前批、本科批A段、本科批B段、本科提前批B段、体育类本科批、体育类本科提前批、国家专项计划本科批、本科提前批C段、艺术类本科提前批、艺术类本科提前批B段、高校专项计划批次、提前一批本科、提前二批本科、本科一批、本科一批A1段、本科一批A段、本科一批B段、本科二批A段、本科二批B段、本科二批C段、高校专项计划批、高校专项计划本科批、本科二批、本科提前批C、专科提前批A段、提前批、零志愿批次、体育类专科批、平行录取一段、平行录取二段、普通类一段、普通类平行录取、普通类提前批、第二批第一段、第二批第二段、地方专项计划本科批、特殊类型招生批、专科批F段、本科批C段、专科特殊类型批次K段、本科一段、本科专项计划批、本科专项计划批E段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二段、专项计划本科、本科提前二批、国家及地方专项、南疆单列、对口援疆计划本科一批、国家及地方专项、南疆单列、对口援疆计划本科一批次、国家及地方专项、南疆单列、对口援疆计划本科二批、国家及地方专项、南疆单列、对口援疆计划本科二批次、高职专科提前批、提前批A段、提前批B段、专科提前批B段、地方农村专项计划批次、综合评价批次、本科批（特殊类型）、特殊类型批、国家专项计划批、提前录取军校批、提前录取本科一批、提前录取本科二批、高职专科提前批E段、综合评价批。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceecollegeline#anchor_related'>历年高考高校录取分数线-查询参数枚举</a>（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `type` | 否 | `string` | - | 科类筛选。当前全部可选值（共 14 项）：综合、艺术类、体育类（历史）、体育类（物理）、历史类、物理类、艺术类（历史）、艺术类（物理）、文科、理科、体育类、蒙授文科、蒙授理科、艺术文。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceecollegeline#anchor_related'>历年高考高校录取分数线-查询参数枚举</a>（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `min` | 否 | `integer` | 0 | 录取最低分查询条件，筛选出最低分小于等于查询条件的值 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `keywordstrict` | 否 | `string` | false | 控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/ceecollegeline/llm.md

### 历年高考专业录取分数线

- 专业录取分数、位次与选科
- 业务角色：专业录取线
- 调用阶段：录取参考
- 接口地址：`GET https://api.gugudata.com/metadata/ceemajorline`
- 产出用途：用于查询高校专业历年录取分数线，适合做专业维度对比。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；分页参数由调用方控制，用于分批读取结果；`SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询
- 可参考的相关能力：历年高考专业录取分数线-查询参数枚举
- [查看接口详情](https://www.gugudata.com/api/details/ceemajorline) · [读取接口 Markdown](https://www.gugudata.com/api/details/ceemajorline/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `integer` | 无 | 必填，取值必须大于 0。查询年份。当前可选值：2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `pageindex` | 是 | `integer` | 无 | 分页参数，第几页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 是 | `integer` | 无 | 分页参数，每页总条数，取值范围在 10 ~ 50 之间 | 分页参数由调用方控制，用于分批读取结果 |
| `schooluuid` | 否 | `string` | - | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 SchoolUUID 进行唯一匹配 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `schoolname` | 否 | `string` | - | 高校名称 (enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空) | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `majorname` | 否 | `string` | - | 专业名称，如电气工程与智能控制、计算机科学与技术等，默认为模糊搜索，可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空) | 专业名称来自用户偏好、专业库或招生计划明细 |
| `subjectSelection` | 否 | `string` | - | 选科要求筛选。当前全部可选值（共 177 项）：不限、不限科目专业组、化/史/技(3选1)、化/史/生(3选1)、化/地/史(3选1)、化/地/技(3选1)、化/地/生(3选1)、化/政/史(3选1)、化/政/地(3选1)、化/政/技(3选1)、化/政/生(3选1)、化/生/地(3选1)、化/生/技(3选1)、化/生/政(3选1)、化、史、生(3科必选)、化、生、政(3科必选)、化史生(3科必选)、化学/地理(2选1)、化学/思想政治(2选1)、化学/技术(2选1)、化学/生物(2选1)、化学、地理(2科必选)、化学、技术(2科必选)、化学、生物(2科必选)、化学必选、历史、历史/地理(2选1)、历史/思想政治(2选1)、历史/生物(2选1)、历史、地理(2科必选)、历史、思想政治(2科必选)、历史必选、史//地(3选1)、史/化/地(3选1)、史/化/技(3选1)、史/化/政(3选1)、史/化/生(3选1)、史/地/技(3选1)、史/地/生(3选1)、史/政/地(3选1)、史/政/技(3选1)、史/生/地(3选1)、史/生/技(3选1)、史/生/政(3选1)、史、化、生(3科必选)、史、政、地(3科必选)、史政地(3科必选)、史生政(3科必选)、地/史/技(3选1)、地/史/生(3选1)、地/生/技(3选1)、地理/历史(2选1)、地理/技术(2选1)、地理/生物(2选1)、地理、历史(2科必选)、地理必选、思想政治/历史(2选1)、思想政治/地理(2选1)、思想政治/技术(2选1)、思想政治/生物(2选1)、思想政治、历史(2科必选)、思想政治、地理(2科必选)、思想政治必选、技术必选、政/史/地(3选1)、政/史/技(3选1)、政/史/生(3选1)、政/地/史(3选1)、政/地/技(3选1)、政/地/生(3选1)、政/生/技(3选1)、政、地、史(3科必选)、政地史(3科必选)、物/化/史(3选1)、物/化/地(3选1)、物/化/技(3选1)、物/化/政(3选1)、物/化/生(3选1)、物/史/化(3选1)、物/史/地(3选1)、物/史/技(3选1)、物/史/政(3选1)、物/史/生(3选1)、物/地/史(3选1)、物/地/技(3选1)、物/地/生(3选1)、物/政/史(3选1)、物/政/地(3选1)、物/政/技(3选1)、物/政/生(3选1)、物/生/地(3选1)、物/生/技(3选1)、物/生/政(3选1)、物、化、地(3科必选)、物、化、技(3科必选)、物、化、生(3科必选)、物、地、技(3科必选)、物、生、政(3科必选)、物化地(3科必选)、物化技(3科必选)、物化政(3科必选)、物化生(3科必选)、物地技(3科必选)、物理、物理/化学(2选1)、物理/历史(2选1)、物理/地理(2选1)、物理/思想政治(2选1)、物理/技术(2选1)、物理/生物(2选1)、物理、化学(2科必选)、物理、历史(2科必选)、物理、地理(2科必选)、物理、思想政治(2科必选)、物理、技术(2科必选)、物理、生物(2科必选)、物理必选、物生技(3科必选)、物生政(3科必选)、生/地/技(3选1)、生/政/地(3选1)、生/政/技(3选1)、生物/地理(2选1)、生物/思想政治(2选1)、生物/技术(2选1)、生物、地理(2科必选)、生物、思想政治(2科必选)、生物、技术(2科必选)、生物必选、首选不限，再选不限、首选不限，再选化学、首选不限，再选化学/生物(2选1)、首选不限，再选思想政治、首选不限，再选生物、首选历史，再选不限、首选历史，再选化学、首选历史，再选化学/地理(2选1)、首选历史，再选化学/思想政治(2选1)、首选历史，再选化学/生物(2选1)、首选历史，再选化学、地理(2科必选)、首选历史，再选化学、生物(2科必选)、首选历史，再选地理、首选历史，再选地理/生物(2选1)、首选历史，再选地理、生物(2科必选)、首选历史，再选思想政治、首选历史，再选思想政治/地理(2选1)、首选历史，再选思想政治/生物(2选1)、首选历史，再选思想政治、地理(2科必选)、首选历史，再选思想政治、生物(2科必选)、首选历史，再选生物、首选历史，再选生物/地理(2选1)、首选历史，再选生物/思想政治(2选1)、首选历史，再选生物、地理(2科必选)、首选历史，再选生物、思想政治(2科必选)、首选物理，再选不限、首选物理，再选化学、首选物理，再选化学/地理(2选1)、首选物理，再选化学/思想政治(2选1)、首选物理，再选化学/生物(2选1)、首选物理，再选化学、地理(2科必选)、首选物理，再选化学、思想政治(2科必选)、首选物理，再选化学、生物(2科必选)、首选物理，再选地理、首选物理，再选地理/生物(2选1)、首选物理，再选地理、生物(2科必选)、首选物理，再选思想政治、首选物理，再选思想政治/地理(2选1)、首选物理，再选思想政治/生物(2选1)、首选物理，再选思想政治、地理(2科必选)、首选物理，再选思想政治、生物(2科必选)、首选物理，再选生物、首选物理，再选生物/化学(2选1)、首选物理，再选生物/地理(2选1)、首选物理，再选生物/思想政治(2选1)、首选物理，再选生物、化学(2科必选)、首选物理，再选生物、地理(2科必选)、首选物理，再选生物、思想政治(2科必选)。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.subjectSelection。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `batchname` | 否 | `string` | - | 专业录取批次筛选，多个值使用英文逗号分隔。当前全部可选值（共 181 项）：一本预科、一类模式本科、专科批、专科批A段、专科批F段、专科提前批、专科提前批A段、专科提前批B段、专科提前批E段、专项计划本科、体育专科提前批、体育本科批、体育本科提前批、体育类专科批、体育类专科提前批、体育类二本及预科批、体育类本科批、体育类本科提前批、体育类本科第二批、体育艺术本一U段、体育艺术本二W段、免费定向批（本科）、分类招生批、区域专项计划本科批、国家专项批、国家专项计划、国家专项计划(本二)、国家专项计划批、国家专项计划本科一批、国家专项计划本科批、国家及地方专项、南疆单列、对口援疆计划本科一批、国家及地方专项、南疆单列、对口援疆计划本科一批次、国家及地方专项、南疆单列、对口援疆计划本科二批、国家及地方专项、南疆单列、对口援疆计划本科二批次、地区专项计划批、地方专项批、地方专项计划、地方专项计划批、地方专项计划本科批、地方优师专项、地方农村专项计划、地方农村专项计划批次、地方农村专项计划本科批、少数民族预科班、平行录取一段、平行录取三段、平行录取二段、提前一批本科、提前二批本科、提前录取军校批、提前录取本科一批、提前录取本科二批、提前批、提前批A段、提前批A类、提前批B段、提前批B类、提前批第一批本科、提前批第二批本科、提前本科批、无批次、普通类一段、普通类二段、普通类平行录取、普通类提前批、本科A批、本科A段、本科B段、本科一批、本科一批-其他、本科一批A1段、本科一批A段、本科一批B段、本科一批H段、本科一批I段、本科一批U段、本科一批预科、本科一段、本科三批、本科三批A段、本科专项计划批、本科专项计划批E段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二批、本科二批-其他、本科二批A段、本科二批B段、本科二批C段、本科二批K段、本科二批及预科、本科二段、本科免费定向批、本科批、本科批A段、本科批A段（国家专项）、本科批A段（地方专项）、本科批B段、本科批C段、本科批一段、本科批平行组、本科批（区域教育均衡发展专项）、本科批（民委专项）、本科批（特殊类型）、本科批（预科）、本科批（高校专项）、本科提前一批、本科提前批、本科提前批-国家专项、本科提前批-高校专项、本科提前批A段、本科提前批A段-高校专项计划、本科提前批B段、本科提前批C、本科提前批C段、本科提前批D段、本科提前批艺术本科第二批、本科提前批艺术类、本科提前批艺术类A段、本科提前批艺术类第1小批、本科提前批艺术类第2小批、本科提前批（国家专项）、本科提前批（第2小批）、本科提前批（高校专项）、本科第一批、本科第一批提前批、本科第一阶段、本科第二批、本科第二批提前批、本科综合评价批、本科艺术甲批平行段、本科预科班批、民航飞行技术批、特殊类型批、特殊类型招生批、第一批、第二批B段、第二批第一段、第二批第二段、综合评价批次、艺本一批、艺术本科A段、艺术本科B段、艺术本科二批、艺术本科批A段、艺术本科批B段、艺术本科批C段、艺术本科提前批、艺术本科提前批B段、艺术类专科批、艺术类专科提前批、艺术类二本及预科批、艺术类本科A段、艺术类本科B段、艺术类本科批、艺术类本科批A段、艺术类本科批B段、艺术类本科提前批、艺术类本科提前批B段、艺术类本科提前批C段、艺术类本科第一阶段、艺术类第一批、艺术类第二批、艺术类第二批B段、艺术类（本科二批B段）、零志愿批次、零批次、预科升学批、高本贯通批、高校专项批、高校专项计划、高校专项计划批、高校专项计划批次、高校专项计划本一批、高校专项计划本科批、高校农村专项计划、高职专科提前批、高职专科提前批D段、高职专科提前批E段、高职（专科）批R段。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `enrollprovince` | 否 | `string` | - | 招生省份筛选，例如江苏。enrollprovince、schoolname、majorname、specialId 四个参数不可同时为空。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `majorNameStrict` | 否 | `boolean` | false | 控制参数 majorname 是否为严格匹配搜索，默认为 false，模糊搜索 | 专业名称来自用户偏好、专业库或招生计划明细 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/ceemajorline/llm.md

### 历年高考省录取分数线

- 各省历年高考批次控制线
- 业务角色：省控线
- 调用阶段：录取参考
- 接口地址：`GET https://api.gugudata.com/metadata/ceeprovince`
- 产出用途：用于查询省级批次控制线，辅助判断批次和填报范围。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；关键词由用户输入或从上一轮内容抽取结果中生成
- [查看接口详情](https://www.gugudata.com/api/details/ceeprovince) · [读取接口 Markdown](https://www.gugudata.com/api/details/ceeprovince/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 否 | `string` | - | 查询年份。当前可选值：2014、2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `keyword` | 否 | `string` | - | 录取省份搜索关键字，例如江苏；为空返回所有数据。省份当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `category` | 否 | `string` | - | 录取科类筛选。当前可选值：3+证书、书法类、体育文、体育理、体育类、其他艺术、农学类、农林类、化工类、医学类、单独招生类、历史类、学考文、学考理、幼师类、广播电视编导类、建筑类、播音与主持类、文科、旅游类、机电类、汉授体育、汉授其他艺术、汉授编导、汉授美术、汉授音乐、汽驾类、烹饪类、牧医类、物理类、理科、畜牧兽医类、综合、美工设计类、美术类、舞蹈类、艺术文、艺术理、艺术类、蒙授体育、蒙授其他艺术、蒙授文科、蒙授理科、蒙授美术、蒙授艺术、蒙授音乐、蒙牧医类、计算机类、财会类、采矿类、音乐类。不同年份、省份下的数据覆盖可能不同。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 高校志愿录取机会与梯度评估模型

- 基于历史招生条件评估高校志愿机会与梯度
- 业务角色：录取概率
- 调用阶段：智能分析
- 接口地址：`POST https://api.gugudata.com/ai/admission/predict`
- 产出用途：用于基于模型估算高校录取概率，适合推荐和排序场景。
- 参数来源：省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举；`SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；专业名称来自用户偏好、专业库或招生计划明细
- 可参考的相关能力：专业录取线按录取概率排序
- [查看接口详情](https://www.gugudata.com/api/details/admission-predict) · [读取接口 Markdown](https://www.gugudata.com/api/details/admission-predict/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `province` | 是 | `string` | 无 | 考生省份，与历史招生资料口径一致。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `subject_type` | 是 | `string` | 无 | 科类或选科；历史资料须满足相同考试量表。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `uuid` | 否 | `string` | 无 | 单个院校标识，可使用高校基础资料的 SchoolUUID。 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `target_college_uuids` | 否 | `array` | 无 | 多个院校标识，兼容已有列表或逗号分隔表达。 | `SchoolUUID` 来自院校基础信息查询结果，也可以由用户指定院校后查询获得 |
| `major_name` | 否 | `string` | 无 | 专业名称；返回实际采用的历史资料层级。 | 专业名称来自用户偏好、专业库或招生计划明细 |
| `year` | 否 | `integer` | 当前配置预测周期 | 请求年份；当前模型按配置预测周期执行，原始请求年份和实际周期见返回元数据，不提供历史回测语义。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `batch` | 否 | `string` | 本科批 | 报考批次。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `local_batch_name` | 否 | `string` | 无 | 本地批次名称，省略时沿用 batch。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `score` | 否 | `number` | 无 | 成绩，与 rank 至少提供一个；可用范围依现有模型和考试量表。 | `score` 为用户高考分数，用于一分一段和录取概率分析 |
| `rank` | 否 | `integer` | 无 | 全省位次，与 score 至少一项；是否实际采用以返回元数据和可用资料为准。 | `rank` 为用户位次，可由一分一段接口或用户输入获得 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/admission-predict/llm.md

### 高校评分实时分析与推荐

- 按高校名称生成六维评分、综合评价与择校分析
- 业务角色：高校评分
- 调用阶段：智能分析
- 接口地址：`POST https://api.gugudata.com/ai/college-score`
- 产出用途：用于实时分析高校综合评分，辅助院校推荐。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- [查看接口详情](https://www.gugudata.com/api/details/college-score) · [读取接口 Markdown](https://www.gugudata.com/api/details/college-score/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `universityName` | 是 | `string` | - | 请求体 JSON 字段，需要评分分析的大学名称，可以传中文名、英文名、简称或全称。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `streaming` | 否 | `boolean` | false | Query 参数，是否启用流式输出，默认 false；true 时响应为 SSE，false 时返回标准 JSON。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 高考教育信息智能助手

- 高考政策、招生章程与志愿信息问答
- 业务角色：高考问答
- 调用阶段：智能问答
- 接口地址：`POST https://api.gugudata.com/ai/gaokao/chat`
- 产出用途：用于构建高考教育信息智能助手。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- [查看接口详情](https://www.gugudata.com/api/details/gaokao-chat) · [读取接口 Markdown](https://www.gugudata.com/api/details/gaokao-chat/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | 是 | `string` | 无 | 非空问题，最多 4000 字符；涉及地方政策时请写明省份和适用年份。示例：填报志愿前应核对哪些官方信息？ | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `session_id` | 否 | `string` | 无 | 可选，最多 256 字符；继续对话时传入上次返回的会话 ID，首次请求不传 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `streaming` | 否 | `boolean` | false | 默认 false 返回 JSON；true 返回 SSE，包含 content、唯一 done 完整结果及 event: end 的 [DONE] 结束标记；中断或错误不代表完成 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 职教高考及高职分类招生控制线

- 职教与高职分类招生控制线
- 业务角色：职教高考控制线
- 调用阶段：扩展场景
- 接口地址：`GET https://api.gugudata.com/metadata/vocational-control-lines`
- 产出用途：用于职教高考和高职分类招生控制线查询。
- 参数来源：`year` 使用考生关注的招生年份、考试年份或历史对比年份；省份参数需要区分考生所在省份、招生省份和院校所在地；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
- 可参考的相关能力：职教高考及高职分类招生控制线-查询参数枚举
- [查看接口详情](https://www.gugudata.com/api/details/vocationalcontrollines) · [读取接口 Markdown](https://www.gugudata.com/api/details/vocationalcontrollines/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `year` | 是 | `integer` | - | 必填正整数，范围 1–65535；实际覆盖以查询结果为准，没有默认年份。 | `year` 使用考生关注的招生年份、考试年份或历史对比年份 |
| `provinceName` | 否 | `string` | - | 招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、重庆、陕西、黑龙江。不同年份、省份下的数据覆盖可能不同。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `pageIndex` | 否 | `integer` | 1 | 页码，默认 1；须为正整数。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 10 | 每页条数，默认 10，范围 1–100。 | 分页参数由调用方控制，用于分批读取结果 |
| `categoryCode` | 否 | `string` | - | 招生类别编码，为空时不按类别编码筛选。当前可选值：75001、75002、75003、75004、75005、75009、75010、75011、75012、75013、75014、75015、75016、75018、75019、75021、75022。不同年份、省份下的数据覆盖可能不同。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `category` | 否 | `string` | - | 招生类别筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related'>职教高考及高职分类招生控制线-查询参数枚举</a>（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.category。请按查询年份 year 和招生省份 provinceName 获取适用取值。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `studentType` | 否 | `string` | - | 考生类型筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related'>职教高考及高职分类招生控制线-查询参数枚举</a>（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.studentType。请按查询年份 year 和招生省份 provinceName 获取适用取值。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `scoreBatch` | 否 | `string` | - | 录取批次筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related'>职教高考及高职分类招生控制线-查询参数枚举</a>（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.scoreBatch。请按查询年份 year 和招生省份 provinceName 获取适用取值。 | 批次参数来自目标省份和年份下可用的批次枚举 |
| `subjectCategory` | 否 | `string` | - | 科类筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related'>职教高考及高职分类招生控制线-查询参数枚举</a>（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.subjectCategory。请按查询年份 year 和招生省份 provinceName 获取适用取值。 | 科类或选科来自用户所在省份当年的可选枚举 |

### 全国中学基础信息

- 按学段、名称和省市查询中学基础资料
- 业务角色：中学基础信息
- 调用阶段：扩展场景
- 接口地址：`GET https://api.gugudata.com/metadata/middle-school`
- 产出用途：用于中学基础数据查询。
- 参数来源：分页参数由调用方控制，用于分批读取结果；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举
- [查看接口详情](https://www.gugudata.com/api/details/middleschool) · [读取接口 Markdown](https://www.gugudata.com/api/details/middleschool/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `pageIndex` | 是 | `integer` | 无 | 页码，从 1 开始。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 是 | `integer` | 无 | 每页 1–20 条。 | 分页参数由调用方控制，用于分批读取结果 |
| `schoolName` | 否 | `string` | - | 学校名称字面包含筛选，空值不筛选。 | 院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询 |
| `provinceName` | 否 | `string` | - | 省份精确筛选，空值不筛选。 | 省份参数需要区分考生所在省份、招生省份和院校所在地 |
| `schoolType` | 否 | `string` | ALL | ALL、MIDDLE_SCHOOL 或 HIGH_SCHOOL，沿用已有效枚举表达。 | 科类或选科来自用户所在省份当年的可选枚举 |
| `cityName` | 否 | `string` | - | 城市精确筛选，空值不筛选。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |

### 全球大学基础信息数据

- 全球高校资料与专业摘要
- 业务角色：全球大学基础信息
- 调用阶段：扩展场景
- 接口地址：`GET https://api.gugudata.com/college/global-university`
- 产出用途：用于海外院校信息展示。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；国家地区来自用户输入、国家地区接口或业务目标市场；分页参数由调用方控制，用于分批读取结果
- 可参考的相关能力：学校专业明细分页查询
- [查看接口详情](https://www.gugudata.com/api/details/global-university) · [读取接口 Markdown](https://www.gugudata.com/api/details/global-university/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 否 | `string` | 无 | 按城市筛选，支持模糊匹配，参数值为空则不进行筛选 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `country` | 否 | `string` | 无 | 按国家筛选，支持模糊匹配，参数值为空则不进行筛选 | 国家地区来自用户输入、国家地区接口或业务目标市场 |
| `pageindex` | 否 | `integer` | 1 | 页码，第几页数据，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 每页数据量，参数最大值为 20，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `name` | 否 | `string` | 无 | 搜索关键字，模糊匹配大学名称或大学中文名称进行模糊匹配，参数值为空则返回所有数据 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `region` | 否 | `string` | 无 | 按地区筛选，支持模糊匹配，参数值为空则不进行筛选 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `sort` | 否 | `string` | rank\|asc | 排序方式，支持的排序字段：rank（排名）、title（大学名称），排序方向：asc（升序）、desc（降序）。格式：字段名\|排序方向 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 全球 QS 世界大学排名数据

- 全球高校排名与评分查询
- 业务角色：全球大学排名
- 调用阶段：扩展场景
- 接口地址：`GET https://api.gugudata.com/metadata/global-university-ranking`
- 产出用途：用于展示 QS 世界大学排名。
- 参数来源：分页参数由调用方控制，用于分批读取结果
- [查看接口详情](https://www.gugudata.com/api/details/global-university-ranking) · [读取接口 Markdown](https://www.gugudata.com/api/details/global-university-ranking/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `pageIndex` | 否 | `integer` | 1 | 分页页码，从 1 开始，默认值为 1。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 10 | 每页返回条数，默认值为 10，取值范围为 1~20。 | 分页参数由调用方控制，用于分批读取结果 |
| `name` | 否 | `string` | 无 | 高校名称检索关键词；支持英文校名、中文校名及已有校名别名，例如 MIT、清华、北京大学；不传时返回分页排名列表。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 职业与发展心理测评

- 查询职业与发展测评问卷，提交答案并查看应用内测试记录
- 业务角色：职业发展测评
- 调用阶段：扩展场景
- 接口地址：`GET https://api.gugudata.com/v1/psychology/questionnaires`
- 产出用途：用于职业与发展心理测评问卷场景。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 可参考的相关能力：获取问卷详情、提交测试答案、查询测试结果、用户测试历史
- [查看接口详情](https://www.gugudata.com/api/details/psychology-questionnaires) · [读取接口 Markdown](https://www.gugudata.com/api/details/psychology-questionnaires/llm.md)

关键请求参数：无额外业务请求参数；调用前仍需按接口详情页配置鉴权和开通状态。

### 考题相似度 AI 分析

- 考题相似度与重复类型分析
- 业务角色：考题相似度
- 调用阶段：扩展场景
- 接口地址：`POST https://api.gugudata.com/education/exam-question-similarity`
- 产出用途：用于考题相似度 AI 分析。
- 参数来源：科类或选科来自用户所在省份当年的可选枚举；文本内容来自用户输入、网页正文抽取或文档识别结果；文件或图片来自用户上传、公开 URL 或上一轮转换结果
- [查看接口详情](https://www.gugudata.com/api/details/exam-question-similarity) · [读取接口 Markdown](https://www.gugudata.com/api/details/exam-question-similarity/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `exam1` | 是 | `string\|object` | - | 第一个题目。可直接传字符串；富文本或图片题传对象，对象字段包括 content、content_type 和 images | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `exam2` | 是 | `string\|object` | - | 第二个题目。格式与 exam1 一致，用于和第一个题目比较 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `exam1.content_type / exam2.content_type` | 否 | `string` | text | 题目对象的内容格式，可选 text、plain_text、html、markdown | 科类或选科来自用户所在省份当年的可选枚举 |
| `exam1.content / exam2.content` | 否 | `string` | - | 题目文字或富文本内容；仅图片题可为空 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `exam1.images / exam2.images` | 否 | `array` | [] | 题目图片，支持 HTTPS 图片地址或 Base64 图片；单题最多 5 张，图片对象可包含 url 和 alt | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |

## 失败处理与恢复

- 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
- 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
- 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
- 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
- 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

## 数据校验与使用边界

- 优先校验年份、省份、批次、科类或选科条件是否一致。
- 分数线和位次只能作为志愿填报参考，高风险决策必须结合考试院和学校官方发布信息。
- 模型预测和院校评分适合辅助排序，不应作为唯一录取判断依据。

## 输出建议

- 输出院校推荐时，按冲、稳、保或概率区间分组。
- 解释结果时同时给出历史分数、位次、招生计划和接口详情页来源。
- 对缺失年份、政策变化、专业组变化和特殊招生类型明确标注限制。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：高考志愿与教育数据 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。

