API 文档
接口地址: https://api.gugudata.com/metadata/primary-school
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/metadata/primary-school?appkey=YOUR_APPKEY&keyword=%e5%ae%9e%e9%aa%8c%e5%b0%8f%e5%ad%a6&schoolType=PRIMARY_SCHOOL&province=%e5%8c%97%e4%ba%ac%e5%b8%82&pageIndex=1&pageSize=20&city=&district=
数据预览: https://www.gugudata.com/preview/primaryschool
接口测试: https://api.gugudata.com/metadata/primary-school/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
YOUR_APPKEY |
付费后获取的 APPKEY。 |
| keyword |
string |
否 |
|
按学校名称或别名模糊搜索,最长 100 个字符。 |
| schoolType |
string |
否 |
ALL |
学校类型:ALL、PRIMARY_SCHOOL、TEACHING_POINT、NINE_YEAR_SCHOOL 或 TWELVE_YEAR_SCHOOL。 |
| province |
string |
否 |
|
省级名称精确筛选,如北京市。 |
| city |
string |
否 |
|
城市名称精确筛选。 |
| district |
string |
否 |
|
区县名称精确筛选。 |
| pageIndex |
integer |
否 |
1 |
页码,从 1 开始。 |
| pageSize |
integer |
否 |
20 |
每页条数,取值范围 1 至 20。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次请求参数。 |
| DataStatus.StatusCode |
integer |
业务状态码。 |
| DataStatus.StatusDescription |
string |
业务状态说明。 |
| DataStatus.ResponseDateTime |
string |
响应时间。 |
| DataStatus.DataTotalCount |
integer |
当前筛选条件下的总记录数。 |
| Data.SchoolId |
string |
学校固定唯一标识。 |
| Data.SchoolName |
string |
学校名称。 |
| Data.SchoolType |
string |
标准学校类型。 |
| Data.Province |
string |
省级名称。 |
| Data.City |
string |
城市名称。 |
| Data.District |
string |
区县名称。 |
| Data.Address |
string|null |
学校地址,无数据时为 null。 |
| Data.Telephone |
string|null |
联系电话,无数据时为 null。 |
| Data.Aliases |
array |
学校别名去重数组。 |
{
"DataStatus": {
"RequestParameter": "province=%E5%8C%97%E4%BA%AC%E5%B8%82&pageIndex=1&pageSize=10",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-08-17 12:00:00.000",
"DataTotalCount": 1
},
"Data": [
{
"SchoolId": "7d5c9fe0-8a46-4b3b-b760-57c198db69bb",
"SchoolName": "示例小学",
"SchoolType": "PRIMARY_SCHOOL",
"Province": "北京市",
"City": "北京市",
"District": "海淀区",
"Address": "示例路 1 号",
"Telephone": null,
"Aliases": [
]
}
]
}