全国大学高校基础信息
GET
https://api.gugudata.com/location/college
GET /location/college业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| keywords | query | string | 否 | 搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据 | |
| uuid | query | string | 否 | 咕咕数据平台高校唯一 ID，可按响应字段 SchoolUUID 精确查询高校基础信息 | |
| schooluuid | query | string | 否 | 学校唯一标识；与 uuid 别名兼容，值冲突明确失败。 | |
| pagesize | query | integer | 否 | 10 | 每页数据量，参数最大值为 20，用于控制分页 |
| pageindex | query | integer | 否 | 1 | 页码，第几页数据，用于控制分页 |
| keywordstrict | query | string | 否 | false | 控制 keywords 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据 |
| collegecategory | query | string | 否 | 院校类别筛选，默认值为空，不进行筛选。当前可选值：中职院校、体育类、其他、其它、军事类、农林类、医药类、师范类、政法类、民族类、理工类、综合类、艺术类、语言类、财经类。 | |
| collegetype | query | string | 否 | 院校类型筛选，默认值为空，不进行筛选。当前可选值：专科（高职）、 中外合作办学、中等专业学校、其它、普通本科、本科、独立学院。 | |
| is985 | query | string | 否 | 是否为 985 院校，需要参与查询则传参为：true | |
| is211 | query | string | 否 | 是否为 211 院校，需要参与查询则传参为：true | |
| isdualclass | query | string | 否 | 是否为双一流院校，需要参与查询则传参为：true | |
| edulevel | query | string | 否 | 院校学历层次筛选，默认值为空，不进行筛选。当前可选值：专科（中职）、专科（高职）、普通本科、本科。 | |
| collegeproperty | query | string | 否 | 院校办学性质筛选，默认值为空，不进行筛选。当前可选值：中外合作办学、公办、内地与港澳台地区合作办学、境外高校独立办学、民办、独立学院。 | |
| sort | query | string | 否 | ranking|asc | 返回数据排序方式，可选值：ranking|asc、ranking|desc；默认按全国排名升序。 |
独立请求示例
{
"keywords": "北京大学",
"keywordStrict": "true",
"pageindex": 1,
"pagesize": 10,
"sort": "ranking|asc"
}返回契约
application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"description": "数据全局唯一 ID，仅用于标识数据的唯一"
},
"SchoolUUID": {
"type": "string",
"description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/ceecollegeline' target='_blank'>历年高考高校录取分数线</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 接口中的 SchoolUUID 进行唯一匹配"
},
"CollegeName": {
"type": "string",
"description": "高校名称，用于学校列表及详情页展示。"
},
"Province": {
"type": "string",
"description": "学院所在省份"
},
"CollegeType": {
"type": "string",
"description": "院校类型筛选，默认值为空，不进行筛选。当前可选值：专科（高职）、中外合作办学、中等专业学校、其它、普通本科、本科、独立学院。"
},
"CollegeCategory": {
"type": "string",
"description": "院校类别筛选，默认值为空，不进行筛选。当前可选值：中职院校、体育类、其他、其它、军事类、农林类、医药类、师范类、政法类、民族类、理工类、综合类、艺术类、语言类、财经类。"
},
"CollegeTags": {
"type": "string",
"description": "学院标签"
},
"EduLevel": {
"type": "string",
"description": "院校学历层次筛选，默认值为空，不进行筛选。当前可选值：专科（中职）、专科（高职）、普通本科、本科。"
},
"CollegeProperty": {
"type": "string",
"description": "院校办学性质筛选，默认值为空，不进行筛选。当前可选值：中外合作办学、公办、内地与港澳台地区合作办学、境外高校独立办学、民办、独立学院。"
},
"Is985": {
"type": "boolean",
"description": "是否为 985 院校"
},
"Is211": {
"type": "boolean",
"description": "是否为 211 院校"
},
"IsDualClass": {
"type": "boolean",
"description": "是否为双一流院校"
},
"CollegeCode": {
"type": "string",
"description": "院校代码；与 SchoolUUID 的跨接口关联标识区分使用。"
},
"Ranking": {
"type": "integer",
"description": "高校排名资料，用于学校概况展示；不等同于招生录取排序。"
},
"RankingInCategory": {
"type": "string",
"description": "高校在所属类别中的排名资料，用于同类别院校对照。"
},
"WebSite": {
"type": "string",
"description": "学院官网"
},
"CallNumber": {
"type": "string",
"description": "学院招生电话"
},
"Email": {
"type": "string",
"description": "学院招生邮箱"
},
"Address": {
"type": "string",
"description": "学院地址"
},
"CoverImage": {
"type": "string",
"description": "学院校徽"
},
"City": {
"type": "string",
"description": "学院所在城市"
},
"District": {
"type": "string",
"description": "学院所在区县"
},
"Coordinate": {
"type": "string",
"description": "学院地理坐标经纬度，格式为 [经度,纬度]，地理坐标系为 GCJ-02。需要转换坐标系请调用 <a href='https://www.gugudata.com/api/details/coordinateconverter' target='_blank'>地理坐标系转换</a> 接口"
},
"Intro": {
"type": "string",
"description": "学院简介"
},
"Expenses": {
"type": "string",
"description": "学院收费说明（Markdown 格式，仅供参考）"
},
"OldName": {
"type": "string",
"description": "学院旧称"
},
"ShortName": {
"type": "string",
"description": "学院简称"
},
"IsDeleted": {
"type": "boolean",
"description": "废弃数据标识"
},
"NumMaster": {
"type": [
"integer",
"null"
],
"description": "高校硕士点数量资料，用于了解研究生培养设置。"
},
"NumDoctor": {
"type": [
"integer",
"null"
],
"description": "高校博士点数量资料，用于了解研究生培养设置。"
},
"GraduateRecommendationQualificationLevel": {
"type": [
"number",
"null"
],
"description": "研究生推免资格等级"
},
"IsMinistryOfEducationDirectlyAffiliated": {
"type": "boolean",
"description": "是否直属教育部"
},
"AffiliatedTo": {
"type": "string",
"description": "隶属于"
},
"MajorList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"MajorTitle": {
"type": "string"
},
"Majors": {
"type": "array",
"items": {
"type": "string"
}
},
"MajorsCode": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Name": {
"type": "string"
},
"Code": {
"type": "string"
},
"LimitYear": {
"type": "string"
},
"Degree": {
"type": "string"
}
},
"required": [
"Name",
"Code",
"LimitYear",
"Degree"
]
}
}
},
"required": [
"MajorTitle",
"Majors",
"MajorsCode"
],
"description": "专业分组对象数组，Majors 与 MajorsCode 一一对应。"
},
"description": "专业分组对象数组，Majors 与 MajorsCode 一一对应。"
},
"DepartmentList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DepartmentName": {
"type": "string"
},
"Majors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"MajorName": {
"type": "string"
},
"EduLevel": {
"type": "string"
}
},
"required": [
"MajorName",
"EduLevel"
]
}
}
},
"required": [
"DepartmentName",
"Majors"
],
"description": "当前已收录的完整院系列表，用于学校、学院（系）、专业三级联动；无有效数据时为空数组，不代表学校没有院系。"
},
"description": "当前已收录的完整院系列表，用于学校、学院（系）、专业三级联动；无有效数据时为空数组，不代表学校没有院系。"
},
"BranchList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"BranchName": {
"type": "string"
},
"BranchAddress": {
"type": "string"
}
},
"required": [
"BranchName",
"BranchAddress"
],
"description": "高校分支或分校资料列表，用于补充学校组织信息。"
},
"description": "高校分支或分校资料列表，用于补充学校组织信息。"
}
},
"required": [
"DataId",
"SchoolUUID",
"CollegeName",
"Province",
"CollegeType",
"CollegeCategory",
"CollegeTags",
"EduLevel",
"CollegeProperty",
"Is985",
"Is211",
"IsDualClass",
"CollegeCode",
"Ranking",
"RankingInCategory",
"WebSite",
"CallNumber",
"Email",
"Address",
"CoverImage",
"City",
"District",
"Coordinate",
"Intro",
"Expenses",
"OldName",
"ShortName",
"IsDeleted",
"NumMaster",
"NumDoctor",
"GraduateRecommendationQualificationLevel",
"IsMinistryOfEducationDirectlyAffiliated",
"AffiliatedTo",
"MajorList",
"DepartmentList",
"BranchList"
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
},
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
501
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "null",
"enum": [
null
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
900
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "null",
"enum": [
null
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数缺失、非法、重复或冲突 | HTTP 400 |
| 900 | 处理、依赖失败或超时 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13