• API 功能
    • 全国所有高校在全国各省的详细录取数据,从 2015 年至 2025 年;
    • 百万级别已校对历史数据;
    • 多种查询条件便于多维度分析;
    • 数据持续自动更新与维护;
    • 毫秒级查询性能;
    • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡。
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/metadata/ceecollegeline

    返回格式: application/json; charset=utf-8

    请求方式: GET

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY
    &searchtype=
    &keyword=
    &pageindex=1
    &pagesize=10
    &year=
    &min=
    &type=
    &keywordstrict=false
    &enrollprovince=
    &batchname=
    &collegeprovincename=
    &enrollmenttype=
    &schooluuid=
    &sort=
    &minrange=0

    数据预览: https://www.gugudata.com/preview/ceecollegeline

    接口测试: https://api.gugudata.com/metadata/ceecollegeline/demo

    请求参数(GET 请求方式可参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string APPKEY 付费后获取的 APPKEY
    searchtype string 查询条件类型,支持录取省份以及高校名称查询,参数值分别为:PROVINCENAME 或 COLLEGENAME
    keyword string 录取省份或高校名称,高校名称支持模糊查询。searchtype=PROVINCENAME,此参数值传递录取省份;searchtype=COLLEGENAME,此参数值传递高校名称。招生省份枚举:上海|云南|内蒙古|北京|台湾|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|澳门|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江
    pageindex int 1 分页参数,第几页
    pagesize int 10 分页参数,每页总条数,取值范围在 1 ~ 20 之间(含)
    year int 查询的录取年份,如 2020、2021、2022、2023、2024、2025。参数默认值为 0:即获取所有年份的录取数据
    min int 录取最低分查询条件,筛选出最低分小于等于查询条件的值
    type string 传递的参数值可选为:3+证书|体育文|体育理|体育类|体育类(历史)|体育类(物理)|其他艺术|农学类|医学类|历史类|学考|学考文|学考理|幼师类|建筑类|文科|旅游类|汉授体育|汉授编导|汉授美术|汉授音乐|汽驾类|烹饪类|牧医类|物理类|理科|综合|美工设计类|艺术文|艺术理|艺术类|艺术类(历史)|艺术类(物理)|蒙授体育|蒙授其他艺术|蒙授文科|蒙授理科|蒙授美术|蒙授音乐|蒙牧医类|计算机类|财会类
    keywordstrict string false 控制 keyword 参数在查询高校名称时是否进行模糊查询,true 为精确匹配,默认值为 false 进行模糊查询
    enrollprovince string 用于 searchtype=COLLEGENAME 时,附加一个招生省份的条件,如查询北京大学在江苏的录取数据,那么该值传递 “江苏” 即可
    batchname string 录取批次参数,可使用英文逗号分隔传递多个值。可选枚举值:专科批|专科批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段
    collegeprovincename string 学院所属省份筛选,如获取所有江苏省高校的录取分数线,那么该值传递 “江苏” 即可,院校省份枚举:上海|云南|内蒙古|北京|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江
    enrollmenttype string 招生类型筛选,如:普通类
    schooluuid string 咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配
    sort string 排序控制,格式为字段+排序类型(asc、desc),支持参数 HighestScore|desc,AverageScore|desc,LowestScore|desc,LowestRank|desc,ProvincialControlLine|desc,EnrollmentType|desc,SelectionLevel|desc
    minrange string 0 录取最低分区间查询条件,使用逗号分隔,左右都为闭区间,格式为:500,700

    返回参数

    参数名 参数类型 备注
    DataStatus.StatusCode int 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount int 此条件下的总数据量,一般用于分页计算
    DataStatus.RequestParameter string 请求参数,一般用于调试
    Data.Province string 招生的省份
    Data.SchoolUUID string 咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配
    Data.CollegeName string 高校名称
    Data.Year int 招生年份
    Data.HighestScore string 录取最高分
    Data.AverageScore string 录取平均分
    Data.LowestScore string 录取最低分
    Data.LowestRank string 录取最低位次
    Data.ProvincialControlLine string 录取省控线
    Data.EnrollmentType string 招生类型
    Data.SelectionLevel string 选测等级(特定省)
    Data.AdmissionBatch string 录取批次。枚举值为:专科批|本科二批|本科一批|本科批|本科三批|本科二批A段|本科提前批|本科批A段|本科一批A段|平行录取二段|本科二批B段|国家专项计划本科批|专科批A段|本科二批C段|平行录取一段|本科二批及预科|普通类一段|本科一批B段|本科三批A段|平行录取三段|本科A批|本科一段|本科批B段|本科二批K段|蒙授高职高专|本科一批I段|普通类二段|本科B批|专科提前批|本科提前批A段|地方专项计划本科批|本科二段|本科一批A1段|国家专项计划本科一批|本科一批预科|本科提前批B段|蒙授本科一批|本科提前批(非军检)|蒙授本科二批|普通类提前批|国家专项计划本科二批|地方农村专项计划批|零批次|高校专项计划本科批|本科三批B段|提前专项批|专科批B段|本科综合评价批|高分优先投档批|普通本科批
    Data.TypeName string 文科、理科或综合。枚举值为:理科|文科|综合|艺术类|体育类|体育理|蒙授理科|艺术文|体育文|汉授美术|蒙授文科|学考文|学考理|艺术理|汉授音乐|汉授体育|其他艺术|汉授编导|蒙授音乐|蒙授体育|蒙授美术|旅游类|计算机类|3+证书|蒙授其他艺术|农学类|财会类|牧医类|蒙牧医类|美工设计类|汽驾类|幼师类|建筑类|烹饪类
    Data.CourseSelection string 选科要求
    Data.CourseSelectionName string 专业组
    Data.SchoolType string 学校类型,如公办、民办
    Data.SchoolInCity string 高校所在的城市
    Data.Is985 boolean 是否为 985 院校
    Data.Is211 boolean 是否为 211 院校
    Data.IsDualClass boolean 是否为双一流院校
    Data.CoverImage string 高校 logo
  • 接口 HTTP 响应标准状态码
    状态码 状态码解释 备注
    200 接口正常响应 业务状态码参见下方 接口自定义状态码
    403 / 429 请求频率超限 CDN 层通过 IP 请求频率智能判断,一般不同 IP 高频请求不会触发此状态码。
  • 接口自定义状态码
    自定义状态码 自定义状态码解释 备注
    100 正常返回 可通过判断此状态码断言接口正常返回。
    -1 请求失败 请求处理请求失败。
    501 参数错误 请检查您传递的参数个数以及参数类型是否匹配。
    429 / 502 请求频率受限 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5),我们不限制同一个 key 的请求总次数,但当单位时间内同一个 IP 请求次数过多,或 AI CDN 判定为恶意抓取数据、流量攻击等异常时,CDN 会返回此状态码,请适当降低请求频率。如有特殊大并发请求场景需求,可联系我们添加白名单处理。
    503 APPKEY 权限超限/订单到期 请至开发者中心检查您的 APPKEY 是否到期或是否权限超限。
    504 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值。
    505 请求的次数超出接口限制 请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数。
    900 接口内部响应错误 接口可用性为 99.999%,如获取到此状态码请邮件联系我们。
  • 请求示例代码
    curl --location --request GET 'https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0'
    CURL *curl;
    CURLcode res;
    curl = curl_easy_init();
    if(curl) {
      curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
      curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0");
      curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
      curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
      struct curl_slist *headers = NULL;
      curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
      res = curl_easy_perform(curl);
    }
    curl_easy_cleanup(curl);
    var requestOptions = {
      method: 'GET',
      redirect: 'follow'
    };
    fetch("https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0", requestOptions)
      .then(response => response.text())
      .then(result => console.log(result))
      .catch(error => console.log('error', error));
    var client = new RestClient("https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0");
    client.Timeout = -1;
    var request = new RestRequest(Method.GET);
    IRestResponse response = client.Execute(request);
    Console.WriteLine(response.Content);
    package main
    import (
      "fmt"
      "net/http"
      "io/ioutil"
    )
    func main() {
      url := "https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0"
      method := "GET"
      client := &http.Client {
      }
      req, err := http.NewRequest(method, url, nil)
      if err != nil {
        fmt.Println(err)
      }
      res, err := client.Do(req)
      defer res.Body.Close()
      body, err := ioutil.ReadAll(res.Body)
      fmt.Println(string(body))
    }
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0")
      .method("GET", null)
      .build();
    Response response = client.newCall(request).execute();
    var settings = {
      "url": "https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0",
      "method": "GET",
      "timeout": 0,
    };
    $.ajax(settings).done(function (response) {
      console.log(response);
    });
    #import <Foundation/Foundation.h>
    dispatch_semaphore_t sema = dispatch_semaphore_create(0);
    NSMutableURLRequest *request =
            [NSMutableURLRequest requestWithURL:[NSURL URLWithString:
            @"https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0"]
      cachePolicy:NSURLRequestUseProtocolCachePolicy
      timeoutInterval:10.0];
    [request setHTTPMethod:@"GET"];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
      } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSError *parseError = nil;
        NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
        NSLog(@"%@",responseDictionary);
        dispatch_semaphore_signal(sema);
      }
    }];
    [dataTask resume];
    dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
    import requests
    url = "https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0"
    payload = {}
    headers= {}
    response = requests.request("GET", url, headers=headers, data = payload)
    print(response.text)
    require "uri"
    require "net/http"
    url = URI("https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0")
    https = Net::HTTP.new(url.host, url.port);
    https.use_ssl = true
    request = Net::HTTP::Get.new(url)
    response = https.request(request)
    puts response.read_body
    import Foundation
    var semaphore = DispatchSemaphore (value: 0)
    var request = URLRequest(url: URL(string:"https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0")!,timeoutInterval: Double.infinity)
    request.httpMethod = "GET"
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
      semaphore.signal()
    }
    task.resume()
    semaphore.wait()
    /*
     * GuGuData API Request Node.js Demo
     * 咕咕数据 API Node.js 请求 DEMO
     * 咕咕数据,专业的数据提供商,提供全面的数据接口 API,并提供专业全面的数据接口、商业数据分析。
     * 让数据成为您的生产原料。
     * https://www.gugudata.com
     */
    
    /* 咕咕数据 API 请求 DEMO ***开始***/
    // 导入相关类库
    var request = require("request");
    var querystring = require("querystring");
    var api_host = "https://api.gugudata.com";
    var api_path = "/metadata/ceecollegeline"; // todo: 注意修改请求对应的 API 接口
    // todo: 注意修改构造请求参数
    var data = {
     appkey:'APPKEY', searchtype:'', keyword:'', pageindex:1, pagesize:10, year:, min:, type:'', keywordstrict:'false', enrollprovince:'', batchname:'', collegeprovincename:'', enrollmenttype:'', schooluuid:'', sort:'', minrange:'0'
    };
    var content = querystring.stringify(data);
    var options = {
        method: "GET",
        url: api_host + api_path + "?" + content,
        headers: {}
    };
    // 发送网络请求
    var requestGuGuData = request(options, (error, response) => {
        if (error) throw new Error(error);
        console.log("********接口响应返回 JSON 数据********");
        console.log(JSON.parse(response.body));
        requestGuGuData.end();
        console.log("********接口响应结束********");
    });
    /* 咕咕数据 API 请求 DEMO ***结束***/
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "GET",
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
  • 更多请求示例与预览数据
  • 常见问题 Q&A
    • Q: 数据请求有缓存吗?

      A: 我们为所有数据请求提供实时响应。对于定期更新的数据,我们在其更新周期内实施缓存策略,以优化性能。

    • Q: 如何保证请求时 key 的安全性?

      A: 我们建议将对 API 的请求操作放置在您的应用程序后端。这样,前端请求只与您的后端服务交互,确保了更高的安全性和易于维护的架构。

    • Q: 接口可以用于哪些开发语言?

      A: 我们的接口支持所有能进行网络请求的开发语言,便于在各类项目中快速整合数据。

    • Q: 接口的性能可以保证吗?

      A: 我们的接口后台使用与商业级项目相同的架构,保证了稳定且高效的性能。您可以通过访问测试接口了解更多性能信息。

  • 服务协议以及服务免责声明

    用户应当充分阅读 服务协议 以及 服务免责声明 ,用户购买与使用咕咕数据 API 服务亦视为接受本协议。

  • 技术支持
    • 技术支持邮箱: support@gugudata.com
    • 微信客服: 客服链接

业务相关接口推荐

稳定提供服务 10 年 全国中学基础信息
  • 提供全国初级高级中学基础数据
  • 定时更新 / 多维度筛选
  • 1499元/年限时折扣 499元/年
查看详情 数据更新于 10 小时前
30% 折扣
稳定提供服务 10 年 全国大学高校基础信息
  • 提供全国大学高校基础信息
  • 每周定时更新 / 高校各类属性
  • 2999元/年限时折扣 999元/年
查看详情 数据更新于 3 小时前
30% 折扣
稳定提供服务 10 年 全国大学高校专业数据
  • 大学专业多维基础数据
  • 持续更新 / 各类专业属性
  • 2999元/年限时折扣 999元/年
查看详情 数据更新于 10 小时前
30% 折扣
稳定提供服务 10 年 历年高考专业录取分数线
  • 高校专业各省录取分数线
  • 复合查询条件 / 千万级数据
  • 4999元/年限时折扣 2499元/年
查看详情 数据更新于 6 小时前
50% 折扣