{ "openapi": "3.1.0", "info": { "title": "GuGuData API", "version": "2026.04.13", "description": "根据接口实现与 APIEntity 文档快照生成的标准 OpenAPI 3.1 规范。" }, "servers": [ { "url": "https://api.gugudata.com", "description": "Production API" } ], "tags": [ { "name": "metadata" } ], "paths": { "/ai/ziwei-fortune": { "post": { "summary": "紫微星斗大师", "description": "基于自研命理推演模型与专有训练优化策略\n接口特性：\n- 基于自研命理推演模型与专有训练优化策略，提供高精度紫微命盘推演与解读；\n- 支持结构化出生信息输入，便于业务系统与自动化流程稳定接入；\n- 覆盖十二宫位、主辅星、四化、大限与流年趋势等核心解读结果；\n- 输出面向产品消费的结构化 JSON，适合前端展示、报告生成与会员服务场景；\n- 智能提炼事业、财运、感情、健康等方向的重点建议，便于用户快速理解；\n- 数据仅供娱乐和参考；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ziwei-fortune", "tags": [ "ai" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "基本信息": { "type": "object" }, "命盘摘要": { "type": "string" }, "十二宫位": { "type": "object" }, "主星与辅星": { "type": "object" }, "四化分析": { "type": "object" }, "大限": { "type": "array", "items": { "type": "object" } }, "流年趋势": { "type": "object" }, "综合建议": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ziwei-fortune", "x-gugudata-test-url": "https://api.gugudata.com/ai/ziwei-fortune/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ziwei-fortune", "parameters": [ { "name": "streaming", "in": "query", "required": false, "schema": { "type": "boolean", "default": "false" }, "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "gender": { "type": "string" }, "calendarType": { "type": "string" }, "birthDate": { "type": "string", "format": "date" }, "birthTime": { "type": "string" }, "birthPlace": { "type": "string" }, "isLeapMonth": { "type": "boolean", "default": false } }, "required": [ "gender", "calendarType", "birthDate", "birthTime", "birthPlace" ] }, "example": { "gender": "女", "calendarType": "公历", "birthDate": "1990-12-01", "birthTime": "07:00", "birthPlace": "江苏苏州", "isLeapMonth": false } }, "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "gender": { "type": "string" }, "calendarType": { "type": "string" }, "birthDate": { "type": "string", "format": "date" }, "birthTime": { "type": "string" }, "birthPlace": { "type": "string" }, "isLeapMonth": { "type": "boolean", "default": false } }, "required": [ "gender", "calendarType", "birthDate", "birthTime", "birthPlace" ] } } } }, "security": [ { "AppKeyQuery": [] } ] } }, "/education/exam-question-similarity": { "post": { "summary": "考题相似度 AI 分析", "description": "基于 AI 的相似度评估\n接口特性：\n- 基于自有专业模型进行 AI 智能分析\n- 提供详细的相似度评分和结果描述\n- 高效的模型分析性能\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）\n- 全面兼容 Apple ATS\n- 全国多节点 CDN 部署\n- 接口极速响应，多台服务器构建 API 接口负载均衡\n详情页：https://www.gugudata.com/api/details/exam-question-similarity", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "score": { "type": "string" }, "analysis_result": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "exam-question-similarity", "x-gugudata-test-url": "https://api.gugudata.com/education/exam-question-similarity/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/exam-question-similarity", "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "exam1": { "type": "string" }, "exam2": { "type": "string" } }, "required": [ "exam1", "exam2" ] } } } }, "security": [ { "AppKeyQuery": [] } ] } }, "/location/college": { "get": { "summary": "全国大学高校基础信息", "description": "提供全国大学高校基础信息\n接口特性：\n- 2025 年数据已更新；\n- 提供最新全国高校学院基本信息；\n- 总计近 4000 条全国高校精准数据；\n- 每周一次数据自动更新校正；\n- 包含高校各类属性、地理坐标、校徽图片、简称、旧称等信息；\n- 包含高校开设专业列表；\n- 毫秒级响应性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/college", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "DataId": { "type": "string" }, "SchoolUUID": { "type": "string" }, "CollegeName": { "type": "string" }, "Province": { "type": "string" }, "City": { "type": "string" }, "District": { "type": "string" }, "Coordinate": { "type": "string" }, "CollegeType": { "type": "string" }, "Is985": { "type": "boolean" }, "Is211": { "type": "boolean" }, "IsDualClass": { "type": "boolean" }, "CollegeCategory": { "type": "string" }, "CollegeTags": { "type": "string" }, "EduLevel": { "type": "string" }, "CollegeProperty": { "type": "string" }, "CollegeCode": { "type": "string" }, "Ranking": { "type": "integer", "format": "int32" }, "RankingInCategory": { "type": "string" }, "WebSite": { "type": "string" }, "CallNumber": { "type": "string" }, "Email": { "type": "string" }, "Address": { "type": "string" }, "BranchList": { "type": "string" }, "CoverImage": { "type": "string" }, "Intro": { "type": "string" }, "Expenses": { "type": "string" }, "OldName": { "type": "string" }, "ShortName": { "type": "string" }, "MajorList": { "type": "object", "properties": { "MajorTitle": { "type": "string" }, "Majors": { "type": "string" } } }, "IsDeleted": { "type": "boolean" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "college", "x-gugudata-test-url": "https://api.gugudata.com/location/college/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/college", "parameters": [ { "name": "keywords", "in": "query", "required": true, "schema": { "type": "string", "default": "KEYWORDS" }, "description": "搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据" }, { "name": "pageindex", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "页码，第几页数据，用于控制分页" }, { "name": "pagesize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "每页数据量，参数最大值为 20，用于控制分页" }, { "name": "keywordStrict", "in": "query", "required": false, "schema": { "type": "string", "default": "false" }, "description": "控制 keyword 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据" }, { "name": "collegecategory", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学院类别，参数默认值为空，不进行筛选。参数可选枚举值：理工类|综合类|师范类|财经类|医药类|艺术类|农林类|军事类|政法类|语言类|体育类|民族类|其它" }, { "name": "collegeType", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学院性质，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科|远程教育学院|中外合作办学||独立学院|高职高专|HND项目|其它|成人教育|专科（高职）" }, { "name": "is985", "in": "query", "required": false, "schema": { "type": "string" }, "description": "是否为 985 院校，需要参与查询则传参为：true" }, { "name": "is211", "in": "query", "required": false, "schema": { "type": "string" }, "description": "是否为 211 院校，需要参与查询则传参为：true" }, { "name": "isDualClass", "in": "query", "required": false, "schema": { "type": "string" }, "description": "是否为双一流院校，需要参与查询则传参为：true" }, { "name": "eduLevel", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询学院学制，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科|本科|专科（高职）|专科|其它" }, { "name": "collegeProperty", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询学院资质，参数默认值为空，不进行筛选。参数可选枚举值: 公办|民办|中外合作办学" }, { "name": "schooluuid", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/ceecollegeline": { "get": { "summary": "历年高考高校录取分数线", "description": "高校在各省录取分数线\n接口特性：\n- 2024 年数据已更新完毕；\n- 全国所有高校在全国各省的详细录取数据，从 2015 年至 2024 年；\n- 百万级别已校对历史数据；\n- 多种查询条件便于多维度分析；\n- 数据持续自动更新与维护；\n- 毫秒级查询性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ceecollegeline", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "Province": { "type": "string" }, "SchoolUUID": { "type": "string" }, "CollegeName": { "type": "string" }, "Year": { "type": "integer", "format": "int32" }, "HighestScore": { "type": "string" }, "AverageScore": { "type": "string" }, "LowestScore": { "type": "string" }, "LowestRank": { "type": "string" }, "ProvincialControlLine": { "type": "string" }, "EnrollmentType": { "type": "string" }, "SelectionLevel": { "type": "string" }, "AdmissionBatch": { "type": "string" }, "TypeName": { "type": "string" }, "CourseSelection": { "type": "string" }, "CourseSelectionName": { "type": "string" }, "SchoolType": { "type": "string" }, "SchoolInCity": { "type": "string" }, "Is985": { "type": "boolean" }, "Is211": { "type": "boolean" }, "IsDualClass": { "type": "boolean" }, "CoverImage": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ceecollegeline", "x-gugudata-test-url": "https://api.gugudata.com/metadata/ceecollegeline/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ceecollegeline", "parameters": [ { "name": "searchType", "in": "query", "required": true, "schema": { "type": "string" }, "description": "查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME" }, { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string" }, "description": "录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME，此参数值传递录取省份；searchtype=COLLEGENAME，此参数值传递高校名称。招生省份枚举：上海|云南|内蒙古|北京|台湾|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|澳门|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江" }, { "name": "pageIndex", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "分页参数，第几页" }, { "name": "pageSize", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "分页参数，每页总条数，取值范围在 1 ~ 20 之间（含）" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" }, "description": "查询的录取年份，如 2020、2021、2022、2023、2024。参数默认值为 0：即获取所有年份的录取数据" }, { "name": "min", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" }, "description": "录取最低分查询条件，筛选出最低分小于等于查询条件的值" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "传递的参数值可选为：3+证书|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|医学类|历史类|学考|学考文|学考理|幼师类|建筑类|文科|旅游类|汉授体育|汉授编导|汉授美术|汉授音乐|汽驾类|烹饪类|牧医类|物理类|理科|综合|美工设计类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|蒙授体育|蒙授其他艺术|蒙授文科|蒙授理科|蒙授美术|蒙授音乐|蒙牧医类|计算机类|财会类" }, { "name": "keywordStrict", "in": "query", "required": false, "schema": { "type": "string", "default": "false" }, "description": "控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询" }, { "name": "enrollProvince", "in": "query", "required": false, "schema": { "type": "string" }, "description": "用于 searchtype=COLLEGENAME 时，附加一个招生省份的条件，如查询北京大学在江苏的录取数据，那么该值传递 “江苏” 即可" }, { "name": "batchname", "in": "query", "required": false, "schema": { "type": "string" }, "description": "录取批次参数，可使用英文逗号分隔传递多个值。可选枚举值：专科批|专科批A段|专科批B段|专科批F段|专科提前批|专科提前批A段|专科特殊类型批|专科特殊类型批次K段|专项计划批|体育本科提前批|体育类本科批|国家专项计划|国家专项计划本科一批|国家专项计划本科二批|国家专项计划本科批|国家及地方专项、南疆单列、对口援疆计划本科一批次|地方专项计划本科批|地方农村专项计划批|平行录取一段|平行录取三段|平行录取二段|提前一批本科|提前专项批|提前批|提前批A段|提前批B段|提前批第一批本科|提前本科批|普通本科批|普通类一段|普通类二段|普通类平行录取|普通类提前批|本科A批|本科A段|本科B批|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批H段|本科一批I段|本科一批U段|本科一批预科|本科一段|本科三批|本科三批A段|本科三批B段|本科专项计划批|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科批|本科批A段|本科批B段|本科批C段|本科批一段|本科提前批|本科提前批A段|本科提前批B段|本科提前批C|本科提前批C段|本科提前批艺术本科第二批|本科提前批艺术类|本科提前批艺术类A段|本科提前批艺术类第1小批|本科提前批（非军检）|本科第一批提前批|本科综合评价批|本科艺术甲批平行段|第一批|第二批第二段|艺本一批|艺术本科A段|艺术本科批B段|艺术本科提前批|艺术类专科批|艺术类本科A段|艺术类本科批|艺术类本科提前批|艺术类本科提前批B段|艺术类第一批|艺术类（本科二批B段）|蒙授本科一批|蒙授本科二批|蒙授高职高专|零志愿批次|零批次|高分优先投档批|高校专项计划|高校专项计划批次|高校专项计划本科批|高职（专科）批Q段|高职（专科）批R段" }, { "name": "collegeProvinceName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学院所属省份筛选，如获取所有江苏省高校的录取分数线，那么该值传递 “江苏” 即可，院校省份枚举：上海|云南|内蒙古|北京|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "排序控制，格式为字段+排序类型（asc、desc），支持参数 HighestScore|desc,AverageScore|desc,LowestScore|desc,LowestRank|desc,ProvincialControlLine|desc,EnrollmentType|desc,SelectionLevel|desc" }, { "name": "enrollmentType", "in": "query", "required": false, "schema": { "type": "string" }, "description": "招生类型筛选，如：普通类" }, { "name": "schooluuid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配" }, { "name": "minrange", "in": "query", "required": false, "schema": { "type": "string", "default": "0" }, "description": "录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700" }, { "name": "dataUpdatedForm", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/ceeline/one-score-one-section": { "get": { "summary": "历年高考一分一段数据", "description": "各省份高考分数线一分一段统计数据\n接口特性：\n- 2024 年数据已更新完毕；\n- 历年数据第一时间手动校对更新；\n- 支持全国各省份高考分数线一分一段表查询；\n- 包含历年同分段对比数据；\n- 支持物理类、历史类等不同科目选择类型；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ceeline-one-score-one-section", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "ExaminationScore": { "type": "string" }, "CandidateCount": { "type": "integer", "format": "int32" }, "TotalCandidates": { "type": "integer", "format": "int32" }, "RankingRange": { "type": "string" }, "AdmissionBatchName": { "type": "string" }, "MinimumAdmissionScore": { "type": "string" }, "Ranking": { "type": "string" }, "HistoricalScores": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ceeline-one-score-one-section", "x-gugudata-test-url": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section", "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "string" }, "description": "查询的年份，如 2020、2021、2022、2023、2024" }, { "name": "provinceName", "in": "query", "required": true, "schema": { "type": "string" }, "description": "省份名称，如：北京、上海、江苏等" }, { "name": "subjectSelection", "in": "query", "required": true, "schema": { "type": "string" }, "description": "科目选择类型，如：物理类、历史类等，需要注意对应的年份和省份下，科目选择类型可能不同" }, { "name": "isArtLine", "in": "query", "required": false, "schema": { "type": "boolean", "default": "false" } }, { "name": "artLineType", "in": "query", "required": false, "schema": { "type": "string", "default": "\"统考成绩排名\"" } }, { "name": "pageIndex", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "分页参数，第几页，默认值为1" }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "分页参数，每页条数，取值范围在 1 ~ 20 之间（含）" } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/ceemajor": { "get": { "summary": "全国大学高校专业数据", "description": "大学专业多维基础数据\n接口特性：\n- 2024 年数据已更新；\n- 提供最新全国高校专业基本信息；\n- 数据定时自动更新与校正；\n- 同时包含专业开设课程列表；\n- 毫秒级响应性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ceemajor", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "EducationLevel": { "type": "string" }, "DisciplinaryCategory": { "type": "string" }, "DisciplinarySubCategory": { "type": "string" }, "MajorCode": { "type": "string" }, "MajorName": { "type": "string" }, "MajorIntroduction": { "type": "string" }, "Courses": { "type": "object", "properties": { "CourseName": { "type": "string" }, "CourseDifficulty": { "type": "string" } } }, "GraduateScale": { "type": "string" }, "MaleFemaleRatio": { "type": "string" }, "RecommendSchools": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ceemajor", "x-gugudata-test-url": "https://api.gugudata.com/metadata/ceemajor/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ceemajor", "parameters": [ { "name": "pageIndex", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "页码，第几页数据，第一页从 1 开始" }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "每页数据量，参数最大值为 20" }, { "name": "keywords", "in": "query", "required": false, "schema": { "type": "string" }, "description": "搜索关键字，模糊匹配专业名称、学科、专业介绍、开设课程。参数值为空则分页返回所有数据" }, { "name": "code", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/ceemajorline": { "get": { "summary": "历年高考专业录取分数线", "description": "高校专业各省录取分数线\n接口特性：\n- 2024 年录取数据已更新完毕 (极少特殊高校数据持续更新中)，每年数据定时更新；\n- 全国高校各专业在全国各省的详细录取数据，从 2018 年至 2024 年；\n- 一千多万条已智能校对数据；\n- 提供按照高校分组的专业枚举信息前置查询接口；\n- 在已有数据基础上，有定制化的接口也可联系我们；\n- 多种查询参数条件便于多维度分析；\n- 返回数据包含该专业录取的最低分、最高分、平均分、最低位次等信息；\n- 数据持续更新与维护；\n- 毫秒级查询性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 接口安全标准全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ceemajorline", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "ProvinceName": { "type": "string" }, "SchoolUUID": { "type": "string" }, "SchoolName": { "type": "string" }, "MajorName": { "type": "string" }, "MajorCode": { "type": "integer", "format": "int32" }, "Year": { "type": "integer", "format": "int32" }, "HighSocre": { "type": "integer", "format": "int32" }, "AverageScore": { "type": "integer", "format": "int32" }, "LowestScore": { "type": "integer", "format": "int32" }, "LowestSection": { "type": "integer", "format": "int32" }, "BatchName": { "type": "string" }, "TypeName": { "type": "string" }, "ProScore": { "type": "integer", "format": "int32" }, "subjectSelection": { "type": "string" }, "MajorStandardCode": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ceemajorline", "x-gugudata-test-url": "https://api.gugudata.com/metadata/ceemajorline/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ceemajorline", "parameters": [ { "name": "pageIndex", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "分页参数，第几页" }, { "name": "pageSize", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "分页参数，每页总条数，取值范围在 10 ~ 50 之间" }, { "name": "enrollProvince", "in": "query", "required": false, "schema": { "type": "string" }, "description": "招生省份的条件，如查询北京大学计算机科学与技术专业在江苏的录取数据，那么该值传递 “江苏” 即可。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)，招生省份可选枚举：上海|云南|内蒙古|北京|台湾|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江" }, { "name": "schoolName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "高校名称。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)" }, { "name": "majorName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "专业名称，如电气工程与智能控制、计算机科学与技术等，默认为模糊搜索，可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "0" }, "description": "查询的录取年份，如 2020、2021、2022、2023、2024。参数默认值为 0：即获取所有年份的录取数据" }, { "name": "min", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "0" }, "description": "录取最低分查询条件，筛选出最低分小于等于查询条件的值。默认值为 0，不进行筛选" }, { "name": "batchName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "专业所属的录取批次，可使用英文逗号分隔传递多个值，格式为：本科二批,专科批。传递参数可选值为：一类模式本科|专科批|专科批A段|专科批F段|专科提前批|专科提前批B段|专科提前批E段|体育专科提前批|体育本科批|体育本科提前批|体育类专科批|体育类专科提前批|体育类本科批|体育类本科提前批|体育类本科第二批|体育艺术本一U段|体育艺术本二W段|分类招生批|区域专项计划本科批|国家专项计划|国家专项计划本科一批|国家专项计划本科批|国家及地方专项、南疆单列、对口援疆计划本科一批次|国家及地方专项、南疆单列、对口援疆计划本科二批次|地方专项计划批|地方专项计划本科批|地方农村专项计划本科批|少数民族预科班|平行录取一段|平行录取三段|平行录取二段|提前一批本科|提前二批本科|提前批|提前批A段|提前批B段|提前批第一批本科|提前批第二批本科|提前本科批|无批次|普通类一段|普通类二段|普通类平行录取|普通类提前批|本科A批|本科A段|本科B段|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批H段|本科一批I段|本科一批U段|本科一批预科|本科一段|本科三批|本科三批A段|本科专项计划批|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科免费定向批|本科批|本科批A段|本科批B段|本科批C段|本科批一段|本科批平行组|本科提前一批|本科提前批|本科提前批A段|本科提前批B段|本科提前批C|本科提前批C段|本科提前批艺术本科第二批|本科提前批艺术类|本科提前批艺术类A段|本科提前批艺术类第1小批|本科提前批（第2小批）|本科第一批|本科第一批提前批|本科第一阶段|本科第二批|本科第二批提前批|本科综合评价批|本科艺术甲批平行段|特殊类型招生批|第一批|第二批B段|第二批第一段|第二批第二段|艺本一批|艺术本科A段|艺术本科B段|艺术本科二批|艺术本科批A段|艺术本科批B段|艺术本科批C段|艺术本科提前批|艺术本科提前批B段|艺术类专科批|艺术类专科提前批|艺术类本科A段|艺术类本科B段|艺术类本科批|艺术类本科批A段|艺术类本科批B段|艺术类本科提前批|艺术类本科提前批B段|艺术类第一批|艺术类第二批|艺术类第二批B段|艺术类（本科二批B段）|零志愿批次|零批次|高校专项计划|高校专项计划批次|高校专项计划本科批|高职（专科）批R段" }, { "name": "typeName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "专业所属的类型，传递参数可选值为：3+证书|会计类|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|农林类|医学类|历史类|园林类|土建类|学考|学考文|学考理|幼师类|建筑类|护理类|教育类|文科|旅游类|服装设计与工艺类|机械加工类|汉授美术|汉授音乐|汽车类|汽驾类|烹饪类|牧医类|物理类|理科|电子商务类|电子技术类|电气技术类|畜牧兽医类|综合|美工设计类|美术类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|药剂类|蒙授体育|蒙授文科|蒙授理科|蒙牧医类|计算机类|财会类|财经类|音乐类" }, { "name": "schooluuid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配" }, { "name": "minrange", "in": "query", "required": false, "schema": { "type": "string" }, "description": "录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700" }, { "name": "specialId", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32" }, "description": "专业 Id，如 22748，用于精确控制搜索的专业。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)" }, { "name": "subjectSelection", "in": "query", "required": false, "schema": { "type": "string" }, "description": "选科要求筛选条件，如：首选物理，再选化学。传递参数可选值为：不限|化/史/地(3选1)|化/史/生(3选1)|化/地/史(3选1)|化/地/生(3选1)|化/政/史(3选1)|化/政/生(3选1)|化/生/史(3选1)|化/生/地(3选1)|化/生/政(3选1)|化学/地理(2选1)|化学/生物(2选1)|化学、物理(2科必选)|化学、生物(2科必选)|化学必选|历史/地理(2选1)|历史/思想政治(2选1)|历史/物理(2选1)|历史/生物(2选1)|历史、地理(2科必选)|历史、思想政治(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科必选)|史、生、地(3科必选)|地/化/生(3选1)|地/史/生(3选1)|地/物/化(3选1)|地/物/生(3选1)|地、史、政(3科必选)|地化物(3科必选)|地史政(3科必选)|地政物(3科必选)|地理/历史(2选1)|地理/物理(2选1)|地理、历史(2科必选)|地理、物理(2科必选)|地理必选|思想政治/历史(2选1)|思想政治/地理(2选1)|思想政治、历史(2科必选)|思想政治必选|政/化/生(3选1)|政/史/化(3选1)|政/史/地(3选1)|政/史/物(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科必选)|物、化、生(3科必选)|物化生(3科必选)|物理/化学(2选1)|物理/历史(2选1)|物理/地理(2选1)|物理/思想政治(2选1)|物理/生物(2选1)|物理、化学(2科必选)|物理、地理(2科必选)|物理、思想政治(2科必选)|物理、生物(2科必选)|物理必选|生/史/地(3选1)|生/政/史(3选1)|生/政/地(3选1)|生化物(3科必选)|生物/历史(2选1)|生物、化学(2科必选)|生物、物理(2科必选)|生物必选|首选不限，再选不限|首选不限，再选化学|首选历史，再选不限|首选历史，再选化学|首选历史，再选化学/地理(2选1)|首选历史，再选化学/思想政治(2选1)|首选历史，再选化学/生物(2选1)|首选历史，再选化学、地理(2科必选)|首选历史，再选化学、生物(2科必选)|首选历史，再选地理|首选历史，再选地理/生物(2选1)|首选历史，再选思想政治|首选历史，再选思想政治/地理(2选1)|首选历史，再选思想政治/生物(2选1)|首选历史，再选思想政治、地理(2科必选)|首选历史，再选生物|首选历史，再选生物/地理(2选1)|首选历史，再选生物/思想政治(2选1)|首选历史，再选生物、地理(2科必选)|首选历史，再选生物、思想政治(2科必选)|首选物理，再选不限|首选物理，再选化学|首选物理，再选化学/地理(2选1)|首选物理，再选化学/思想政治(2选1)|首选物理，再选化学/生物(2选1)|首选物理，再选化学、地理(2科必选)|首选物理，再选化学、生物(2科必选)|首选物理，再选地理|首选物理，再选地理/生物(2选1)|首选物理，再选地理、生物(2科必选)|首选物理，再选思想政治|首选物理，再选思想政治/地理(2选1)|首选物理，再选思想政治/生物(2选1)|首选物理，再选思想政治、地理(2科必选)|首选物理，再选生物|首选物理，再选生物/地理(2选1)|首选物理，再选生物/思想政治(2选1)|首选物理，再选生物、地理(2科必选)" }, { "name": "majorNameStrict", "in": "query", "required": false, "schema": { "type": "boolean", "default": "false" }, "description": "控制参数 majorname 是否为严格匹配搜索，默认为 false，模糊搜索" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } }, { "name": "dataUpdatedForm", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } }, { "name": "excludeMajorCategory", "in": "query", "required": false, "schema": { "type": "boolean", "default": "false" } } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/ceeprovince": { "get": { "summary": "历年高考省录取分数线", "description": "高考各批次省录取分数线\n接口特性：\n- 2014 年 - 2024 年全国各省高考录取数据；\n- 完整录取批次数据；\n- 多种搜索参数满足各类数据筛选需求；\n- 数据持续定时自动更新；\n- 全接口支持 HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3)；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/ceeprovince", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "Province": { "type": "string" }, "Category": { "type": "string" }, "ScoreBatch": { "type": "string" }, "Year": { "type": "integer", "format": "int32" }, "Score": { "type": "integer", "format": "int32" }, "SpecialName": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "ceeprovince", "x-gugudata-test-url": "https://api.gugudata.com/metadata/ceeprovince/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/ceeprovince", "parameters": [ { "name": "keyword", "in": "query", "required": true, "schema": { "type": "string" }, "description": "录取省份搜索关键字，如江苏。为空返回所有数据" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "录取数据的年份，2014 - 2024" }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "录取学科分类筛选，综合、文科理科等。可选枚举值：理科 | 文科 | 综合 | 艺术类 | 物理类 | 历史类 | 体育类 | 艺术文 | 艺术理 | 体育理 | 体育文 | 蒙授理科 | 蒙授文科 | 汉授美术 | 汉授音乐 | 汉授编导 | 汉授其他艺术 | 蒙授其他艺术 | 蒙授体育 | 蒙授音乐 | 蒙授美术 | 汉授体育 | 学考理 | 医学类 | 学考文 | 广播电视编导类 | 舞蹈类 | 美术类 | 音乐类 | 计算机类 | 农学类 | 财会类 | 化工类 | 美工设计类 | 牧医类 | 采矿类 | 幼师类 | 蒙牧医类 | 旅游类 | 机电类 | 建筑类 | 汽驾类 | 书法类 | 农林类 | 烹饪类 | 畜牧兽医类" } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/college-enrollment-plan": { "get": { "summary": "历年高校招生计划数据", "description": "各高校历年招生计划数据\n接口特性：\n- 2024 年数据已更新完毕；\n- 支持历年高校招生计划数据查询，包含 2018 年至 2024 年数据；\n- 包含各高校招生计划详细数据，百万级数据；\n- 多维度查询条件支持；\n- 毫秒级查询性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/collegeenrollmentplan", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "InSchoolYears": { "type": "string" }, "ClassOne": { "type": "string" }, "ClassTwo": { "type": "string" }, "BatchName": { "type": "string" }, "Type": { "type": "string" }, "SchoolName": { "type": "string" }, "EnrollmentNumbers": { "type": "integer", "format": "int32" }, "SchoolUUID": { "type": "string" }, "CourseSelectionRequirements": { "type": "string" }, "CollegeMajorName": { "type": "string" }, "ShortCollegeMajorName": { "type": "string" }, "CollegeMajorCode": { "type": "string" }, "Year": { "type": "integer", "format": "int32" }, "ProvinceName": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "collegeenrollmentplan", "x-gugudata-test-url": "https://api.gugudata.com/metadata/college-enrollment-plan/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/collegeenrollmentplan", "parameters": [ { "name": "pageIndex", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "分页参数，第几页" }, { "name": "pageSize", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "分页参数，每页总条数，取值范围在 10 ~ 100 之间（含）" }, { "name": "classone", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的专业大类" }, { "name": "classtwo", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的专业小类" }, { "name": "batchName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "录取批次参数，可选枚举值：专科批|专科批A段|专科批F段|专科提前批|专科提前批A段|专科提前批B段|专科提前批E段|体育类本科批|体育类第一段|国家专项计划|国家专项计划本科批|地方专项计划本科批|平行录取一段|提前一批本科|提前二批本科|提前批|提前批第一批本科|提前批第二批专科|提前批第二批本科|普通类一段|普通类二段|普通类平行录取|普通类平行录取段|普通类提前批|本科A段|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批I段|本科一批T段|本科一批U段|本科一段|本科三批|本科三批A段|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科免费定向批|本科批|本科批A段|本科批B段|本科批C段|本科提前一批|本科提前二批|本科提前批|本科提前批A段|本科提前批B段|本科提前批C段|本科第一批|本科第一批提前批|本科第二批|本科第二批提前批|本科综合评价批|特殊类型招生批|艺术本科A段|艺术本科二批|艺术本科批A段|艺术本科批B段|艺术本科批C段|艺术本科提前批B段|艺术类本科A段|艺术类本科批|艺术类第一批A段|艺术类第二批|零志愿批次|零批次|高校专项计划本科批|高职（专科）批R段" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "传递的参数值可选为：理科|文科|综合|艺术类|体育类|体育理|蒙授理科|艺术文|体育文|汉授美术|蒙授文科|学考文|学考理|艺术理|汉授音乐|汉授体育|其他艺术|汉授编导|蒙授音乐|蒙授体育|蒙授美术|旅游类|计算机类|3+证书|蒙授其他艺术|农学类|财会类|牧医类|蒙牧医类|美工设计类|汽驾类|幼师类|建筑类|烹饪类" }, { "name": "schoolname", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的高校名称，支持模糊查询" }, { "name": "provincename", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的招生省份" }, { "name": "collegemajorname", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的高校专业名称，支持模糊查询" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询的招生年份，如 2020、2021、2022、2023、2024。参数默认值为 0：即获取所有年份的招生计划数据" }, { "name": "schooluuid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配" }, { "name": "dataUpdatedForm", "in": "query", "required": false, "schema": { "type": "string", "default": "\"\"" } } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/global-university-ranking": { "get": { "summary": "全球 QS 世界大学排名数据", "description": "详细排名指标和得分信息\n接口特性：\n- 提供全球 QS 世界大学排名数据；\n- 每个季度定时更新数据；\n- 支持按学校名称模糊搜索；\n- 包含详细的排名指标和得分信息；\n- 支持分页查询；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/global-university-ranking", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "Id": { "type": "string" }, "UniversityName": { "type": "string" }, "Region": { "type": "string" }, "Country": { "type": "string" }, "City": { "type": "string" }, "LogoUrl": { "type": "string" }, "Rank": { "type": "string" }, "AcademicReputationRank": { "type": "string" }, "AcademicReputationScore": { "type": "string" }, "CitationsPerFacultyRank": { "type": "string" }, "CitationsPerFacultyScore": { "type": "string" }, "FacultyStudentRatioRank": { "type": "string" }, "FacultyStudentRatioScore": { "type": "string" }, "EmployerReputationRank": { "type": "string" }, "EmployerReputationScore": { "type": "string" }, "EmploymentOutcomesRank": { "type": "string" }, "EmploymentOutcomesScore": { "type": "string" }, "InternationalStudentRatioRank": { "type": "string" }, "InternationalStudentRatioScore": { "type": "string" }, "InternationalResearchNetworkRank": { "type": "string" }, "InternationalResearchNetworkScore": { "type": "string" }, "InternationalFacultyRatioRank": { "type": "string" }, "InternationalFacultyRatioScore": { "type": "string" }, "SustainabilityRank": { "type": "string" }, "SustainabilityScore": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "global-university-ranking", "x-gugudata-test-url": "https://api.gugudata.com/metadata/global-university-ranking/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/global-university-ranking", "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学校名称，支持模糊搜索，不传则返回所有数据" }, { "name": "pageIndex", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "分页参数，第几页，默认值为1" }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "分页参数，每页条数，取值范围在 1 ~ 20 之间（含）" } ], "security": [ { "AppKeyQuery": [] } ] } }, "/metadata/middle-school": { "get": { "summary": "全国中学基础信息", "description": "提供全国初级高级中学基础数据\n接口特性：\n- 2024 年数据已更新；\n- 提供最新全国中学学校基本信息；\n- 包含全国初级中学与高等中学；\n- 总计近 10 万条全国中学精准数据；\n- 每月一次数据自动更新校正；\n- 包含学校各类属性信息；\n- 毫秒级响应性能；\n- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；\n- 全面兼容 Apple ATS；\n- 全国多节点 CDN 部署；\n- 接口极速响应，多台服务器构建 API 接口负载均衡。\n详情页：https://www.gugudata.com/api/details/middleschool", "tags": [ "metadata" ], "responses": { "200": { "description": "请求成功，业务状态码请参考响应体中的状态字段。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": { "type": "object", "properties": { "Id": { "type": "string" }, "SchoolName": { "type": "string" }, "SchoolType": { "type": "string" }, "Province": { "type": "string" }, "City": { "type": "string" }, "District": { "type": "string" }, "Address": { "type": "string" }, "PostalCode": { "type": "string" }, "PhoneCode": { "type": "string" } } } } } } } }, "400": { "description": "请求参数错误。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "401": { "description": "鉴权失败。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "403": { "description": "无权限、订单到期或额度不可用。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "404": { "description": "请求路径不存在。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "405": { "description": "请求方法不允许。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "415": { "description": "请求内容类型不支持。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "429": { "description": "请求频率超限。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "500": { "description": "服务内部异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } }, "502": { "description": "上游依赖异常。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "$ref": "#/components/schemas/ApiDataStatus" }, "Data": {} } } } } } }, "x-gugudata-api-identity": "middleschool", "x-gugudata-test-url": "https://api.gugudata.com/metadata/middle-school/demo", "x-gugudata-details-url": "https://www.gugudata.com/api/details/middleschool", "parameters": [ { "name": "pageIndex", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "1" }, "description": "页码，第几页数据" }, { "name": "pageSize", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32", "default": "10" }, "description": "每页数据量，参数最大值为 20" }, { "name": "schoolType", "in": "query", "required": false, "schema": { "type": "string", "default": "ALL" }, "description": "中学类型：ALL (不限制) | MIDDLE_SCHOOL (初级中学) | HIGH_SCHOOL (高级中学)" }, { "name": "schoolName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学校名称，模糊搜索，参数默认值为空，不进行筛选" }, { "name": "provinceName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学校所在省份，参数默认值为空，不进行筛选" }, { "name": "cityName", "in": "query", "required": false, "schema": { "type": "string" }, "description": "学校所在城市，参数默认值为空，不进行筛选" } ], "security": [ { "AppKeyQuery": [] } ] } } }, "components": { "securitySchemes": { "AppKeyQuery": { "type": "apiKey", "in": "query", "name": "appkey", "description": "咕咕数据开发者中心分配的 APPKEY。" } }, "schemas": { "ApiDataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string" }, "StatusCode": { "type": "integer", "description": "历史业务状态码，保持兼容。" }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string", "format": "date-time" }, "DataTotalCount": { "type": "integer", "format": "int32" } } }, "ApiV2DataStatus": { "type": "object", "properties": { "requestParameter": { "type": "string" }, "statusCode": { "type": "integer", "description": "历史业务状态码，保持兼容。" }, "statusDescription": { "type": "string" }, "responseDateTime": { "type": "string", "format": "date-time" }, "dataTotalCount": { "type": "integer", "format": "int32" } } } } } }