1. 教育/高考
咕咕数据 API 文档
  • 文档首页
  • 条码工具
    • DEMO
      • 通用二维码生成 DEMO
      • Wi-Fi 无线网二维码生成 DEMO
      • 通用条形码生成 DEMO
      • [DEMO] 通用二维码解析读取
    • 通用二维码生成
    • Wi-Fi 无线网二维码生成
    • 通用条形码生成
    • 通用二维码解析读取
  • 金融/基础
    • A 股
      • DEMO
        • [DEMO] A 股财报 AI 智能解读
        • [DEMO] A 股上市公司公告
        • [DEMO] A 股实时行情数据
        • [DEMO] A 股历史行情数据
        • [DEMO] A 股分时交易数据
        • [DEMO] A 股个股信息查询
        • [DEMO] A 股三大财报
        • [DEMO] A 股财务指标
        • [DEMO] A 股指数成分数据
        • [DEMO] A 股指数实时行情数据
        • [DEMO] A 股指数历史行情数据
        • [DEMO] A 股盘前数据
        • [DEMO] A 股分笔交易数据
        • [DEMO] A 股股票列表编码
        • [DEMO] A 股交易日历
        • [DEMO] A 股指数分时行情数据
        • [DEMO] A 股个股资金流
        • [DEMO] A 股个股资金流排行
        • [DEMO] A 股期权实时行情数据
        • [DEMO] A 股买卖盘口数据
        • [DEMO] A 股涨停板实时数据
        • [DEMO] A 股季度业绩报表
        • [DEMO] A 股科创板历史行情数据
      • A 股股票编码列表
      • A 股实时行情数据
      • A 股历史行情数据
      • A 股分钟行情数据
      • A 股分笔交易数据
      • A 股盘前数据
      • A 股个股信息查询
      • A 股三大财报
      • A 股财务指标
      • A 股指数列表
      • A 股指数成分数据
      • A 股指数实时行情数据
      • A 股指数历史行情数据
      • A 股指数分时行情数据
      • A 股股票列表
      • A 股交易日历
      • A 股期权实时行情数据
      • A 股个股资金流
      • A 股个股资金流排行
      • A 股买卖盘口数据
      • A 股涨停板实时数据
      • A 股季度业绩报表
      • A 股科创板历史行情数据
      • 查询 A 股股票代码列表数据,支持分页查询
      • A 股财报 AI 智能解读
      • A 股上市公司公告
    • 港股
      • DEMO
        • [DEMO] 港股指数实时行情数据
        • [DEMO] 港股股票指数历史行情数据
        • [DEMO] 港股三大财报
        • [DEMO] 港股实时行情接口
        • [DEMO] 港股历史行情接口
        • [DEMO] 港股分时行情数据
        • [DEMO] 港股上市公司公告
        • [DEMO] 港股基础信息数据
        • [DEMO] 港股股本与现价数据
      • 港股基础信息数据
      • 港股指数代码枚举
      • 港股指数实时行情数据
      • 港股股票指数历史行情数据
      • 港股三大财报
      • 港股实时行情接口
      • 港股历史行情接口
      • 港股分时行情数据
      • 港股上市公司公告
      • 港股股票代码列表
      • 港股股本与现价数据
    • 美股
      • DEMO
        • [DEMO] 美股实时行情数据
        • 美股历史行情数据 DEMO
        • 美股分时行情数据 DEMO
        • [DEMO] 分类美股实时行情数据
        • 美股历年基本财务数据 Demo
      • 查询美股股票代码列表数据
      • 美股实时行情数据
      • 美股历史行情数据
      • 美股分时行情数据
      • 分类美股实时行情数据
      • 美股历年基本财务数据
      • 查询美股股票代码列表数据,支持分页查询
  • 商业/分析
    • DEMO
      • [DEMO] 公募基金组合风险分析
      • [DEMO] 基金基本信息
      • [DEMO] 指数基金业绩
      • [DEMO] 场内基金分时行情
      • [DEMO] 开放式基金最新净值
      • [DEMO] 开放式基金区间净值
      • [DEMO] 开放式基金业绩排行
      • [DEMO] 场内基金业绩排行
      • [DEMO] 公募基金实时净值
      • [DEMO] 公募基金历史数据
      • [DEMO] 场内基金历史净值
      • [DEMO] 场内基金实时净值
      • [DEMO] 开放式基金盘中净值估算
      • [DEMO] 国际货币汇率
      • [DEMO] 期权实时行情数据
    • 金融
      • DEMO
    • 公募基金实时净值
    • 公募基金历史数据
    • 场内基金分时行情
    • 场内基金实时净值
    • 基金基本信息
    • 场内基金历史净值
    • 指数基金业绩
    • 开放式基金最新净值
    • 开放式基金区间净值
    • 开放式基金业绩排行
    • 场内基金业绩排行
    • 开放式基金盘中净值估算
    • 公募基金代码枚举
    • 公募基金组合风险分析
    • 国际货币汇率
    • 期权实时行情数据
  • 教育/高考
    • DEMO
      • 院校与专业三年录取明细示例
      • [DEMO] 全球大学基础数据
      • [DEMO] 全国中学基础信息
      • [DEMO] 全国大学高校专业数据
      • [DEMO] 全国大学高校基础信息
      • [DEMO] 高考省分数线
      • [DEMO] 历年高考高校录取分数线
      • [DEMO] 历年高考专业录取分数线
      • [DEMO] 历年高考高校招生计划
      • [DEMO] 考题相似度 AI 分析
      • [DEMO] 历年高考一分一段数据
      • [DEMO] 全球 QS 世界大学排名数据
      • [DEMO] 分数线区间筛选录取信息联合查询
      • [DEMO] 高校实时分析与推荐评分
      • [DEMO] 高校志愿录取机会与梯度评估模型
      • [DEMO] 高考教育信息智能助手
      • [DEMO] 职教高考及高职分类招生控制线
      • [DEMO] 研究生招生专业目录
      • [DEMO] 研究生招生国家分数线
      • [DEMO] 历年高校招生计划院校招生代码
      • [DEMO] 全国小学基础信息
      • [DEMO] 全国公职与国企招录岗位数据
    • 职业性格问卷
      • DEMO
        • [DEMO] 职业与发展心理测评问卷
      • 获取问卷详情
      • 查询测试结果
      • [查询列表] 职业性格问卷
      • [查询列表] 查询职业性格问卷详情
      • [提交] 职业性格问卷
      • [查询] 职业性格问卷
      • [查询] 用户测试历史
    • [枚举] 职教高考控制线查询参数
      GET
    • 考题文档相似度分析(异步提交)
      POST
    • 考题文档对比任务查询
      GET
    • 全国小学基础信息
      GET
    • 专业录取线按录取概率排序
      POST
    • 院校与专业三年录取明细
      GET
    • 全球 QS 世界大学排名数据
      GET
    • 全球大学基础数据
      GET
    • 全国中学基础信息
      GET
    • 全国大学高校基础信息
      GET
    • 全国大学高校专业数据
      GET
    • 历年高考省录取分数线
      GET
    • 历年高考高校录取分数线
      GET
    • 历年高考专业录取分数线
      GET
    • 分数线区间筛选录取信息联合查询
      GET
    • 按照学校名称或学校 ID 查询高校的专业信息
      GET
    • 历年高考高校招生计划
      GET
    • 考题相似度 AI 分析(Equivalent)
      POST
    • 历年高考一分一段数据
      GET
    • [枚举] 历年高考一分一段选科枚举
      GET
    • 高校实时分析与推荐评分
      POST
    • 高校志愿录取机会与梯度评估模型
      POST
    • 高考教育信息智能助手
      POST
    • 职教高考及高职分类招生控制线
      GET
    • 研究生招生专业目录
      GET
    • 研究生招生国家分数线
      GET
    • [枚举] 历年高考一分一段查询参数
      GET
    • [枚举] 历年高考高校录取分数线查询参数
      GET
    • [枚举] 历年高考专业录取分数线查询参数
      GET
    • 考题相似度 AI 分析(Exact / Header)
      POST
    • 学校专业明细分页查询
      GET
    • 考题相似度 AI 分析(Variant / Bearer)
      POST
    • 考题文档相似度分析任务状态
      GET
    • [枚举] 历年高校招生计划查询参数
      GET
    • 全国公职与国企招录岗位数据
      GET
    • 历年高校招生计划院校招生代码
      GET
  • 图像/转换
    • DEMO
      • [DEMO] 通用 OCR
      • [DEMO] HTML 转 PDF
      • [DEMO] HTML 转 WORD
      • [DEMO] Markdown 转 PDF
      • [DEMO] 图片 OCR 转 Word
      • [DEMO] PDF 解析格式化输出
      • [DEMO] 通用文件流 OCR
      • [DEMO] 通用 OCR PDF 到 Word
      • [DEMO] PDF 分割拆分
      • [DEMO] PDF 转 HTML
      • [DEMO] PPT 转高精度图片
      • [DEMO] 通用 PDF 文件流 OCR 到文本
      • [DEMO] PPT 转高精度 PDF
      • [DEMO] Word 转 HTML
      • [DEMO] 图片压缩与尺寸优化
    • 通用 OCR
    • HTML 转 PDF
    • HTML 转 WORD
    • Markdown 转 PDF
    • 图片 OCR 转 Word
    • PDF 解析格式化输出
    • 通用文件流 OCR
    • 通用 OCR PDF 到 Word
    • PDF 分割拆分
    • PDF 转 HTML
    • PPT 转高精度图片
    • 通用 PDF 文件流 OCR 到文本
    • PPT 转高精度 PDF
    • Word 转 HTML
    • 图片压缩与尺寸优化(本地文件)
    • 图片压缩(公开 URL / Header 鉴权)
    • 图片压缩(公开 URL / Bearer 鉴权)
  • AI/模型
    • 模型
    • DEMO
      • [DEMO] 发票与小票结构化识别
      • [DEMO] 文章自然润色
      • [DEMO] 多语言 AI 翻译
      • [DEMO] 个人可识别信息 (PII) 去除
      • [DEMO] PDF 全文多语言 AI 摘要
      • [DEMO] 长文本多语言 AI 摘要
      • [DEMO] 多语言长文本 AI 关键字提取
      • [DEMO] 多语言文本 AI 情感分析
      • [DEMO] 多语言文本 AI 纠错格式化
      • [DEMO] 主题诗歌创作
      • [DEMO] 儿童故事创作大师
      • [DEMO] AI 文档字段结构化解析
      • [DEMO] 私有文档知识库问答
    • 上传知识库文档
    • AI RAG 文档知识库问答
    • 文章抽取信息化 JSON
    • 发票与小票结构化识别
    • 删除知识库文档
    • 删除知识库会话
    • 文章自然润色
    • 多语言 AI 翻译
    • 个人可识别信息 (PII) 去除
    • PDF 全文多语言 AI 摘要
    • 长文本多语言 AI 摘要
    • 多语言长文本 AI 关键字提取
    • 多语言文本 AI 情感分析
    • 多语言文本 AI 纠错格式化
    • 主题诗歌创作
    • 儿童故事创作大师
    • AI 文档字段结构化解析(同步文本)
    • 上传知识库文档
    • AI 文档知识库问答
    • 从 HTML 提取文章内容
    • AI 文档字段结构化解析(DOCX 文件)
    • AI 文档字段结构化解析(异步提交)
    • AI 文档字段结构化解析任务状态
  • 元数据/资讯
    • 汽车车型库数据
      • DEMO
        • [DEMO] 车型品牌列表
        • [DEMO] 车型库聚合预览
      • 车型品牌列表
      • 品牌下车系列表
      • 车系详情
      • 车系下车型列表
    • 汽车/车型
      • 车型
        • 获取车系详情
      • 汽车车型库数据
        • DEMO
          • [DEMO] 品牌下车系列表
          • [DEMO] 车系详情
          • [DEMO] 车系下车型列表
    • DEMO
      • [DEMO] 文章正文
      • [DEMO] 文章正文图片列表
      • [DEMO] 笑话大全
      • [DEMO] 公众号头条文章
      • [DEMO] 获取公众号文章封面
      • [DEMO] 开发者技术资讯
    • 开发者技术资讯
    • 文章正文
    • 文章正文图片列表
    • 公众号头条文章
    • 笑话大全
    • 获取公众号文章封面
  • 天气/空气质量
    • DEMO
      • [DEMO] 天气预报信息
      • [DEMO] 日出日落
      • [DEMO] 农历与二十四节气
      • [DEMO] 多地区实时空气质量
      • [DEMO] 全球天气预报
    • 查询天气区域的编码
    • 查询地区编码,根据市或区的关键字进行查询,如北京、苏州、海淀、吴中等
    • 全球天气预报信息
    • 日出日落
    • 农历与二十四节气
    • 多地区实时空气质量
    • 全球天气预报
  • 区域/坐标
    • DEMO
      • [DEMO] 全国省市区街道区域信息
      • IP地址定位 DEMO
      • 地理坐标系转换 DEMO
      • [DEMO] 国家地区基础信息数据
      • [DEMO] 国际 IP 地址定位
      • [DEMO] 全国三级甲等医院基础信息
    • 地理坐标系转换
    • 全国省市区街道区域信息
    • 全国省市区街道区域信息导出
    • 全国省市区街道区域信息 v2
    • IP地址定位
    • 国家地区基础信息数据
    • 国际 IP 地址定位
    • 全国三级甲等医院基础信息
  • 文本/NLP
    • DEMO
      • 中英文排版规范化 DEMO
      • 关键字摘要智能提取 DEMO
      • 百万中国对联数据 DEMO
      • 唐诗宋词 DEMO
      • 简体繁体转换 DEMO
      • ISBN DEMO
      • [DEMO] 中文文本分词
      • [DEMO] 文本语义相似度检测
      • [DEMO] NLP 命名实体识别
      • [DEMO] NLP 中文智能纠错
      • [DEMO] 人工智能对联生成
      • [DEMO] NLP 语种检测
      • [DEMO] 中文转拼音
      • [DEMO] 核心英汉词典查询
    • 中英文排版规范化
    • 关键字摘要智能提取
    • 百万中国对联数据
    • 唐诗宋词
    • 简体繁体转换
    • 中文文本分词
    • ISBN
    • 文本语义相似度检测
    • NLP 命名实体识别
    • NLP 中文智能纠错
    • 人工智能对联生成
    • NLP 语种检测
    • 中文转拼音
    • 核心英汉词典查询
  • 网站工具
    • 短信/语音
      • DEMO
    • DEMO
      • [DEMO] 手机归属地查询
      • [DEMO] 国际手机号码检查纠正
      • [DEMO] 获取站点以及图标 DEMO
      • [DEMO] 域名 Whois 查询
      • [DEMO] 网页可读内容抽取
      • [DEMO] 域名 SSL 证书信息解析
      • [DEMO] 域名 DNS 信息查询
      • [DEMO] URL 转静态 HTML 文件
      • [DEMO] URL 转网站截图
      • [DEMO] 网页转结构化 Markdown
      • [DEMO] 网页所有 URL 结构化输出
      • [DEMO] 网站截图与 HTML 快照
      • [DEMO] 文章抽取信息化 JSON
      • [DEMO] 语义化获取站点 JSON 结构内容
      • [DEMO] 网页性能与 SEO 评分
    • 搜索/可见性
      • 结果查询
        • 获取搜索可见性报告
        • 搜索可见性观测任务列表
        • 获取搜索可见性观测任务
        • 搜索可见性观测结果列表
        • 获取搜索可见性观测结果
      • 创建搜索可见性报告
      • 搜索可见性报告列表
      • 创建搜索可见性观测任务
      • [DEMO] 搜索可见性 SERP 数据接口
    • 国际手机号码检查纠正
    • 获取站点以及图标
    • 域名 Whois 查询
    • 网页可读内容抽取
    • 域名 SSL 证书信息解析
    • 域名 DNS 信息查询
    • URL 转静态 HTML 文件
    • URL 转网站截图
    • 网页转结构化 Markdown
    • 网页所有 URL 结构化输出
    • 网站截图与 HTML 快照
    • 语义化获取站点 JSON 结构内容
    • 网页性能与 SEO 评分
    • 手机归属地查询
    • 获取搜索可见性报告
    • 创建搜索可见性观测任务
    • 搜索可见性观测任务列表
    • 获取搜索可见性观测结果
    • 获取搜索可见性观测任务
    • 搜索可见性观测结果列表
  • 国学/娱乐
    • DEMO
      • [DEMO] 盲派八字推理
      • [DEMO] 紫微星斗大师
      • [DEMO] 八字喜用神起名大师
      • [DEMO] 八字每日趋势解读
      • [DEMO] 八字关系合参
      • [DEMO] 生肖周期趋势解读
      • [DEMO] 传统历法宜忌参考
      • [DEMO] 星座周期趋势解读
    • 盲派八字推理
    • 紫微星斗大师
    • 八字喜用神起名大师
    • 任务状态查询
    • 八字每日趋势解读
    • 八字关系合参(同步)
    • 生肖周期趋势解读(同步)
    • 生肖周期趋势解读(异步任务)
    • 生肖周期趋势解读任务状态
    • 生肖周期趋势解读(SSE)
    • 八字每日趋势解读(异步任务)
    • 传统历法宜忌参考(同步)
    • 八字每日趋势解读(SSE)
    • 星座周期趋势解读(同步)
    • 八字关系合参任务状态
    • 国学 AI 异步任务状态查询
    • 八字关系合参(异步任务)
    • 八字关系合参(SSE)
    • 星座周期趋势解读(异步任务)
    • 星座周期趋势解读任务状态
    • 星座周期趋势解读(SSE)
    • 传统历法宜忌参考(异步任务)
    • 传统历法宜忌参考任务状态
    • 传统历法宜忌参考(SSE)
  • 数据模型
    • DataStatus
    • CommonResponse
    • AdmissionErrorResponse
首页
咕咕数据官网
API 分类
API 分类
  • 图像/转换
  • AI/模型
  • 文字/NLP
  • 新闻/资讯
  • 教育/高考
  • 金融/基础
  • 商业/分析
  • 区域/坐标
  • 网站工具
  • 条码工具
  • 天气/空气质量
  • 短信/语音
首页
咕咕数据官网
API 分类
API 分类
  • 图像/转换
  • AI/模型
  • 文字/NLP
  • 新闻/资讯
  • 教育/高考
  • 金融/基础
  • 商业/分析
  • 区域/坐标
  • 网站工具
  • 条码工具
  • 天气/空气质量
  • 短信/语音
接口状态
  1. 教育/高考

高校志愿录取机会与梯度评估模型

POST
https://api.gugudata.com/ai/admission/predict
基于历史招生条件评估高校志愿机会与梯度
评估是历史条件参考,不是个人真实录取率或录取承诺。不同考试量表不可直接比较;有效请求无适用资料时保留空结果与 NoDataReason。Query 业务值沿用覆盖 Body 的兼容规则,多值列表可重复传递;凭据必须一致。
输入考生省份、科类和成绩,整理同类考试条件下的高校志愿参考;
按目标高校名称名单评估,便于核对关注院校的机会分;
支持使用高校唯一 ID 关联院校基础信息与评估对象;
按高校所在地省份筛选,整理目标地区的院校候选;
可启用本省优先,调整符合条件院校的推荐顺序;
使用 Top-N 控制返回院校数量,整理不同长度的志愿候选清单;
按自定义概率区间和每档数量整理多档志愿梯度;
提供概率、院校排名和综合策略三种档内排序方式;
支持专业级参考,资料不足时标明采用院校整体资料的参考结果;
提供录取参考概率、机会分与梯度解释,辅助人工比较院校;
展示实际使用的历史年份、分差及可用的招生计划覆盖依据;
返回证据一致性状态,帮助核对解释与结构化结果是否对应;

当前接口契约#

接口详情:https://www.gugudata.com/api/details/admission-predict

请求参数#

参数类型必填默认值说明
appkeystring否无付费后获取的 APPKEY。支持 AppKey、X-GUGUDATA-APPKEY、X-API-Key 请求头、Bearer、Query 和历史 JSON 鉴权字段;多处一致凭据允许,重复或冲突凭据失败。 AppKey 整体必填;在本操作已声明支持的鉴权位置任选一个提供,本位置无需重复填写。多处填写时须一致。
provincestring是无考生所在省份,与历年分数线数据保持一致
subject_typestring是无科类/选科:理科、文科、物理类、历史类、综合等
scorenumber否无考生裸分,与 rank 至少提供一项;一般省份 0–750,海南最高 900。仅位次请求是否可评估取决于当前模型与分段位次资料,无法换算时返回明确无数据原因。
rankinteger否无考生全省位次,与 score 至少提供一项。保留该历史参数;当前模型未采用位次时以 meta.rank_source、effective_rank 说明,不将传入位次视为已参与计算。
batchstring否本科批报考批次,目前支持普通本科批次
top_ninteger否50返回院校数量上限,范围 1-200;传入 probability_tiers 时按各档位数量返回
probability_tiersarray否无,不传时使用 top_n概率分层配置,仅支持 JSON Body 传入。示例:[{"name":"safe","label":"保","min_probability":0.98,"limit":3},{"name":"stable","label":"稳","min_probability":0.8,"limit":3},{"name":"reach","label":"冲","min_probability":0.75,"limit":3}]。每项包含 name、label、min_probability、limit;min_probability 必须严格递减,相邻档位自动形成概率区间;可配合 tier_sort 控制每档内部取数顺序,用于一次返回保、稳、冲等多档志愿结果;不传时继续按 top_n 返回。
tier_sortstring否probability概率分层每档内部排序策略,仅在 probability_tiers 生效时使用;可选 probability、college_rank、balanced。probability 按录取概率排序,college_rank 按院校排名优先,balanced 综合院校层次、排名和概率。
include_explanationboolean否false是否返回补充影响因素说明,默认关闭以控制响应时延,开启后仅对部分结果返回解释信息
prefer_localboolean否false是否在排序时优先本省院校
college_provincesarray否无按院校所在省份过滤,留空则不过滤;Query 方式可多次传值,格式 ["江苏", "上海"]
target_collegesarray否无指定院校名单,仅对名单内院校预测
uuidstring否无指定一个院校唯一 ID,仅对该院校预测;可使用全国大学高校基础信息接口返回的 SchoolUUID
target_college_uuidsarray否无指定院校唯一 ID 列表,仅对名单内院校预测;多个值可使用数组或逗号分隔字符串
yearinteger否当前配置预测周期目标招生年份,当前配置预测周期为 2026;兼容保留传入值,实际预测周期以 meta.prediction_year 和 requested_year/effective_year 为准,不提供历史回测语义。
major_namestring否无专业名称(用于专业级预测),命中专业样本时优先返回该专业结果;若样本不足,系统可能切换到院校层或其他兼容预测路径
local_batch_namestring否无本地批次名称(用于过滤),不提供时默认使用 batch 参数的值

正常响应字段#

字段类型说明
DataStatus.StatusCodeinteger接口状态码,100 表示成功
DataStatus.StatusDescriptionstring接口返回状态说明
DataStatus.ResponseDateTimestring返回时间
DataStatus.DataTotalCountinteger本次返回院校数量
Data.predictionsarray预测结果列表
Data.predictions[].college_namestring院校名称
Data.predictions[].admission_probabilitynumber兼容字段:历史条件下的录取参考概率(0-1),永久保留以兼容现有客户
Data.predictions[].chance_scorenumber推荐使用字段:历史条件机会分(0-1),与 admission_probability 数值完全相同
Data.predictions[].recommendationstring兼容字段:保留现有摘要文案和值,现有客户无需修改;新应用建议使用 interpretation
Data.predictions[].long_recommendationstring兼容字段:保留现有长文案和值;新应用建议使用可复算的 long_interpretation
Data.predictions[].interpretationstring推荐使用字段:按固定机会区间返回的志愿梯度解释
Data.predictions[].long_interpretationstring推荐使用字段:只使用同一响应中的结构化证据拼装;证据不足时省略对应句子,证据冲突时停止输出详细数字
Data.predictions[].historical_yearsarray该结果实际使用的历史招生年份;不会根据截至年份和数量推测连续年份
Data.predictions[].data_through_yearinteger该结果实际使用的最新历史招生年份
Data.predictions[].plan_coverageobject招生计划覆盖信息;AVAILABLE 时 ratio 可由 covered_plan_total / school_plan_total 复算,未知不会用 0 表示
Data.predictions[].fallback_pathobject请求层级、实际数据层级、兼容策略和原因码
Data.predictions[].evidence_consistency_statusstring证据复算状态:VERIFIED、PARTIAL 或 FAILED
Data.predictions[].evidenceobject关键证据对象;保留 recent_3y_min_score,并新增具名 historical_score_summary 供年份、最低线、输入分数和分差复算
Data.predictions[].evidence.historical_score_summaryobject具名历史分数摘要,包含 years、latest_min_score、recent_min_score_average、student_score、gap_to_latest_min 和 gap_to_recent_min_average
Data.predictions[].shap_explanationobject补充影响因素说明,仅在 include_explanation=true 且当前结果可解释时返回
Data.predictions[].major_namestring命中专业级预测时返回对应专业名称;若结果回退到院校层,则该字段可能为空
Data.predictions[].tier_namestring命中的概率档位标识,仅在请求 probability_tiers 时返回
Data.predictions[].tier_labelstring命中的概率档位展示名称,仅在请求 probability_tiers 时返回
Data.predictions[].tier_min_probabilitynumber命中档位的录取概率下限,仅在请求 probability_tiers 时返回;下一档会自动以上一档下限作为概率上界
Data.meta.total_collegesinteger返回院校数量
Data.meta.student_scorenumber考生分数
Data.meta.student_provincestring考生省份
Data.meta.local_collegesinteger结果中同省院校数量,无 is_local 字段时为 null
Data.meta.score_diff_minnumber分差绝对值最小值
Data.meta.score_diff_mediannumber分差绝对值中位数,用于梯度判断
Data.meta.prefer_localboolean是否启用本省优先排序
Data.meta.college_provincesarray请求中用于过滤院校省份的列表
Data.meta.model_versionstring模型版本号
Data.meta.data_through_yearinteger本次返回结果实际使用的最新历史招生年份
Data.meta.historical_yearsarray本次返回结果实际使用的历史招生年份并集
Data.meta.coverage_levelstring本次结果的历史数据覆盖等级;结果层级不一致时为 mixed
Data.meta.interpretation_policy_versionstring机会与梯度解释策略版本
Data.meta.policy_constraintsobject请求级政策评估边界,列出已评估项、未评估项及核对提示
Data.meta.probability_tiersarray概率分层返回统计,仅在请求 probability_tiers 时返回;每项包含 name、label、min_probability、limit、returned_count,下一档会自动以上一档下限作为概率上界
Data.meta.tier_sortstring本次概率分层每档内部排序策略,仅在请求 probability_tiers 时返回
Data.meta.fallback.appliedboolean是否启用了 fallback 或补充预测策略
Data.meta.fallback.strategystringfallback 策略标识,用于说明当前结果采用的兼容预测路径
Data.meta.fallback.requested_yearinteger请求中传入的目标预测年份
Data.meta.fallback.effective_yearinteger实际用于匹配分数线或历史样本的有效年份
Data.meta.fallback.requested_major_namestring请求中传入的专业名称
Data.meta.fallback.effective_major_namestring实际命中的参考专业名称;若未命中稳定专业样本则为空
Data.meta.fallback.reasonstring采用兼容预测路径时返回稳定原因码;未采用时为空
Data.disclaimerstring免责声明
DataStatus.RequestParameterstring实际业务参数,不包含凭据。
DataStatus.RequestIdstring本次请求的关联标识。
DataStatus.NoDataReasonstring有效请求无可评估结果时返回稳定原因;有结果时省略。
Data.meta.requested_yearinteger请求中传入的年份。
Data.meta.prediction_yearinteger当前实际模型预测周期。
Data.meta.rank_sourcestring实际位次来源;missing 表示本次模型没有采用可用位次。
Data.meta.effective_rankinteger实际参与评估的位次;未采用时为 null。

业务状态说明#

业务状态码业务状态码解释备注
100正常返回
501参数错误缺少省份、科类、appkey,或成绩与位次均缺失,以及重复、冲突、类型或范围无效时返回;HTTP 422。
502请求频率受限请降低请求频率
503APPKEY 过期或订单失效请前往开发者中心确认订单有效期
504APPKEY 错误请检查传递的 APPKEY 是否正确
505超出调用次数当前 APPKEY 已达到订单调用上限
-9预测失败或服务处理异常预测依赖失败使用 HTTP 503,超时或不可达使用 HTTP 504,内部错误使用 HTTP 500;机器状态说明具体类别。

返回数据结构#

字段类型
Data.predictions[].plan_coverage.rationumber / null
Data.predictions[].plan_coverage.matched_plan_rowsinteger / null
Data.predictions[].plan_coverage.covered_plan_totalinteger / null
Data.predictions[].plan_coverage.school_plan_totalinteger / null
Data.predictions[].fallback_path.reasonstring / null
计划覆盖数值在不适用或资料不足时可以为 null;没有可用回退原因时 reason 可以为 null。

常见问题#

填写 rank 后,如何知道位次是否用于本次预测?#

score 和 rank 至少传一项。响应中请看 Data.meta.rank_source 和 effective_rank;rank_source 为 missing 或 effective_rank 为 null 时,不能认为填写的位次参与了计算。

指定 major_name 后,返回结果一定是该专业的吗?#

不一定。专业样本不足时,可能采用院校资料或其他兼容路径。展示结果时看每条记录的 fallback_path 和实际返回的 major_name;回退到院校层的结果应标为院校参考。

能在一次请求中返回保、稳、冲多档结果吗?#

可以。在 JSON 请求体的 probability_tiers 中配置各档的 name、label、min_probability 和 limit。各档下限须严格递减;如不配置分档,继续用 top_n 限制结果数量。

能把 chance_score 当成被院校录取的实际概率吗?#

不能。chance_score 是基于当前可用历史条件计算的 0–1 机会参考值。展示时可结合 historical_years 和证据说明,并让用户以当年招生政策、专业限制和官方招生信息为准。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "province": "江苏",
    "subject_type": "物理类",
    "score": 635,
    "batch": "本科批",
    "top_n": 10,
    "include_explanation": true,
    "prefer_local": false,
    "college_provinces": ["江苏", "上海"],
    "target_colleges": null,
    "year": 2025,
    "major_name": "计算机科学与技术",
    "local_batch_name": "本科批"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://api.gugudata.com/ai/admission/predict?appkey=请前往 https://www.gugudata.com 购买' \
--header 'Content-Type: application/json' \
--data '{
    "province": "江苏",
    "subject_type": "物理类",
    "score": 635,
    "batch": "本科批",
    "top_n": 10,
    "include_explanation": true,
    "prefer_local": false,
    "college_provinces": ["江苏", "上海"],
    "target_colleges": null,
    "year": 2025,
    "major_name": "计算机科学与技术",
    "local_batch_name": "本科批"
}'

返回响应

🟢200成功
application/json
业务成功,状态码 100;合法无匹配结果依产品契约返回。 请求频率限制,业务码 502。 权益已过期,业务码 503。 凭据无效或无接口权限,业务码 504。 调用额度不足,业务码 505。
Bodyapplication/json

示例
{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestId": "string",
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0,
        "NoDataReason": "string"
    },
    "Data": {
        "predictions": [
            {
                "evidence": {
                    "matched_plan_rows": 0,
                    "college_rank": 0,
                    "aggregation_mode": "string",
                    "province_line_gap": 0,
                    "plan_enrollment": 0,
                    "major_hist_avg": 0,
                    "major_recent_min_trend": 0,
                    "covered_plan_total": 0,
                    "score_gap": 0,
                    "school_plan_total": 0,
                    "score_gap_original": 0,
                    "is_211": true,
                    "is_dual_class": true,
                    "historical_score_summary": {
                        "latest_min_score": 0,
                        "recent_min_score_average": 0,
                        "gap_to_latest_min": 0,
                        "years": [
                            0
                        ],
                        "student_score": 0,
                        "gap_to_recent_min_average": 0,
                        "property1": "string",
                        "property2": "string"
                    },
                    "recent_3y_min_score": [
                        0
                    ],
                    "plan_coverage_ratio": 0,
                    "is_985": true,
                    "property1": "string",
                    "property2": "string"
                },
                "admission_probability": 0,
                "recommendation": "string",
                "tier_label": "string",
                "tier_name": "string",
                "college_name": "string",
                "evidence_consistency_status": "string",
                "interpretation": "string",
                "data_through_year": 0,
                "long_interpretation": "string",
                "fallback_path": {
                    "requested_level": "string",
                    "applied": true,
                    "reason": "string",
                    "effective_level": "string",
                    "strategy": "string",
                    "property1": "string",
                    "property2": "string"
                },
                "tier_min_probability": 0,
                "chance_score": 0,
                "historical_years": [
                    0
                ],
                "plan_coverage": {
                    "matched_plan_rows": 0,
                    "school_plan_total": 0,
                    "covered_plan_total": 0,
                    "ratio": 0,
                    "status": "string",
                    "property1": "string",
                    "property2": "string"
                },
                "shap_explanation": {},
                "major_name": "string",
                "long_recommendation": "string"
            }
        ],
        "disclaimer": "string",
        "meta": {
            "model_version": "string",
            "probability_tiers": [
                {
                    "property1": "string",
                    "property2": "string"
                }
            ],
            "score_diff_median": 0,
            "total_colleges": 0,
            "coverage_level": "full",
            "interpretation_policy_version": "string",
            "data_through_year": 0,
            "fallback": {
                "property1": "string",
                "property2": "string"
            },
            "college_provinces": [
                "string"
            ],
            "student_province": "string",
            "historical_years": [
                0
            ],
            "tier_sort": "probability",
            "prefer_local": true,
            "policy_constraints": {
                "not_evaluated": [
                    "string"
                ],
                "notice": "string",
                "status": "string",
                "evaluated": [
                    "string"
                ],
                "property1": "string",
                "property2": "string"
            },
            "score_diff_min": 0,
            "student_score": 0,
            "local_colleges": 0
        }
    }
}
🟠422参数错误(业务码 501)。
🔴503预测失败或服务处理异常(业务码 -9)。
🔴504处理超时,业务码 -9。
🔴500处理异常,业务码 -9。

咕咕数据微信客服

在这里,获得咕咕数据使用上的任何帮助,商用合规的功能型与数据型 API,加速您的业务构建。

扫码咨询客服
修改于 2026-11-16 12:15:50
上一页
高校实时分析与推荐评分
下一页
高考教育信息智能助手
Built with