• API 功能
    • 2014 年 - 2025 年全国各省高考录取数据;
    • 完整录取批次数据;
    • 多种搜索参数满足各类数据筛选需求;
    • 数据持续定时自动更新;
    • 全接口支持 HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡。
    • 接口调用状态与状态监控
  • API 文档

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

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

    请求方式: GET

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/metadata/ceeprovince?appkey=APPKEY&keyword=&year=&category=

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

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

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

    参数名 参数类型 是否必须 默认值 备注
    appkey string APPKEY 付费后获取的 APPKEY
    keyword string 录取省份搜索关键字,如江苏。为空返回所有数据
    year int 录取数据的年份,2014 - 2025
    category string 录取学科分类筛选,综合、文科理科等。可选枚举值:理科 | 文科 | 综合 | 艺术类 | 物理类 | 历史类 | 体育类 | 艺术文 | 艺术理 | 体育理 | 体育文 | 蒙授理科 | 蒙授文科 | 汉授美术 | 汉授音乐 | 汉授编导 | 汉授其他艺术 | 蒙授其他艺术 | 蒙授体育 | 蒙授音乐 | 蒙授美术 | 汉授体育 | 学考理 | 医学类 | 学考文 | 广播电视编导类 | 舞蹈类 | 美术类 | 音乐类 | 计算机类 | 农学类 | 财会类 | 化工类 | 美工设计类 | 牧医类 | 采矿类 | 幼师类 | 蒙牧医类 | 旅游类 | 机电类 | 建筑类 | 汽驾类 | 书法类 | 农林类 | 烹饪类 | 畜牧兽医类

    返回参数

    参数名 参数类型 备注
    DataStatus.StatusCode int 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount int 此条件下的总数据量,一般用于分页计算
    Data.Province string 录取省份
    Data.Category string 录取学科分类,综合、文科理科等。枚举值:理科 | 文科 | 综合 | 艺术类 | 物理类 | 历史类 | 体育类 | 艺术文 | 艺术理 | 体育理 | 体育文 | 蒙授理科 | 蒙授文科 | 汉授美术 | 汉授音乐 | 汉授编导 | 汉授其他艺术 | 蒙授其他艺术 | 蒙授体育 | 蒙授音乐 | 蒙授美术 | 汉授体育 | 学考理 | 医学类 | 学考文 | 广播电视编导类 | 舞蹈类 | 美术类 | 音乐类 | 计算机类 | 农学类 | 财会类 | 化工类 | 美工设计类 | 牧医类 | 采矿类 | 幼师类 | 蒙牧医类 | 旅游类 | 机电类 | 建筑类 | 汽驾类 | 书法类 | 农林类 | 烹饪类 | 畜牧兽医类
    Data.ScoreBatch string 录取批次。枚举值:本科二批 | 本科一批 | 专科批 | 本科三批 | 艺术类(本科) | 艺术类(高职专科) | 体育类(本科) | 本科批 | 体育类(高职专科) | 专科一批 | 特殊类型招生控制线 | 本科二批C段 | 艺术类(本科批) | 体育类(本科一批) | 体育类(本科二批) | 专科批(汉族) | 专科批(独立学院、民办、省属高职除武汉) | 专科批(少数民族) | 专科提前批 | 高水平运动队 | 体育类(本科批) | 普通本科(汉族) | 艺术类(本科一批) | 普通本科(少数民族) | 艺术类(本科二批) | 专科二批 | 自招线 | 艺术A类(本科) | 艺术B类(本科) | 艺术类(平行录取一段) | 本科A段 | 艺术类(平行录取二段) | 本科B段 | 本科一段 | 本科二段 | 地方专项计划本科一批 | 重点本科(少数民族) | 本科提前批 | 重点本科(汉族) | 平行录取二段 | 平行录取一段 | 预科班 | 国家专项计划本科一批 | 地方专项计划批 | 国家专项计划本科二批 | 国家专项计划批 | 本科批(汉族) | 省内专项 | 军校军检线 | 本科批(少数民族) | 部队生源招生本科控制线 | 特殊类型录取控制线(强基计划等) | 民族班及预科 | 平行录取三段 | 体育类(平行录取一段) | 体育类(平行录取二段) | 体育类(专科) | 艺术C类(本科) | 艺术类(本科提前批) | 艺术类(专科提前批) | 教师专项计划 | 一类模式本科 | 艺术类本科文化控制分数线 | 体育类本科文化控制分数线 | 体育类二段(含专业成绩) | 普通类二段 | 普通类一段 | 体育类一段(含专业成绩) | 本科院校卫生专项计划 | 军队本科批 | 国家、地方专项计划 | 艺术类(本科)(校考本科合格) | 重点本科批(少) | 体育类本科批(汉) | 省外院校民族班、民族预科(本科一批) | 高分优先投档线 | 普通本科批 | 省内专项(本科一批) | 本科批A段 | 贫困地区专项计划(本科二批) | 军队提前本科批 | 地方专项计划本科批 | 体育类(本、专科) | 艺术类(本科批)(编导类) | 蒙授本科二批 | 少数民族班 | 蒙授本科一批 | 体育类(本科三批) | 重点本科批 | 艺术类本科批(少) | 省内院校本科民族预科 | 艺术类(高职专科)(校考本科或专科合格) | 地方专项计划本科二批 | 艺术类(高职专科)(播音与主持类) | 蒙授高职高专 | 普通本科批(少) | 艺术类(本科批)(表演类(服装表演)) | 本科批B段 | 高分优先投档批 | 艺术类(本科提前批)(美术与设计学类、音乐学类、戏剧与影视学类) | 省内专项(本科二批) | 体育类本科批(少) | 艺术类(专科) | 艺术类(本科提前批)(舞蹈学类) | 艺术类(高职专科)(摄影摄像类) | 艺术类(高职专科)(书法艺术与书法教育类) | 艺术类本科批(汉) | 艺术类(高职专科)(编导类) | 国家贫困地区专项计划批 | 艺术类(高职专科)(表演类(戏剧表演)) | 贫困地区专项计划(本科一批) | 艺术类(高职专科)(表演类(服装表演)) | 艺术类(高职专科)(舞蹈类) | 专科院校卫生专项计划 | 艺术类(高职专科)(美术类) | 艺术类(高职专科)(音乐类) | 艺术类(本科批)(书法艺术与书法教育类) | 艺术类(本科批)(播音与主持类) | 艺术类(本科批)(表演类(戏剧表演)) | 艺术类(本科批)(舞蹈类) | 艺术类(本科批)(美术类) | 艺术类(本科批)(音乐类) | 艺术类(本科)(舞蹈) | 特殊类型资格线 | 艺术类(本科)(航空服务艺术与管理) | 艺术类(本科)(书法学) | 艺术类(本科)(音乐表演) | 艺术类(本科)(美术设计) | 艺术类(本科批)(摄影摄像类) | 艺术类(本科)(播音编导) | 省外院校民族班、民族预科(本科二批) | 一类模式专科 | 艺术类(本科)(戏剧与影视学类) | 艺术类(平行录取二段)(音乐类) | 艺术类(平行录取二段)(摄制类) | 音乐类(本科) | 本科二批(美术) | 体育类高职(专科)文化控制分数线 | 舞蹈类(本科) | 专科批(广播电视编导) | 艺术类(平行录取一段)(影视表演类) | 本科二批(田径类) | 艺术类本科批 | 本科二批(广播电视编导) | 专科批(航空服务艺术与管理) | 艺术类(本科)(不含戏剧与影视学类) | 本科二批(舞蹈) | 本科一批(唐卡) | 艺术类(平行录取二段)(播音主持类) | 本科一批(播音与主持艺术) | 艺术类(本科)(舞蹈类、影视戏剧表演类、服装表演类) | 艺术类(平行录取一段)(音乐类) | 本科一批(足球排球篮球类) | 广播电视编导类(本科) | 艺术类(平行录取二段)(时装表演类) | 专科批(声乐) | 艺术类高职(专科)文化控制分数线 | 本科一批(美术) | 书法类(本科) | 艺术类(平行录取一段)(摄制类) | 本科二批(器乐) | 本科一批(体操武术类) | 专科批(播音与主持艺术) | 艺术类(平行录取二段)(舞蹈类) | 艺术类(平行录取一段)(编导类) | 专科批(体操武术类) | 艺术类(平行录取一段)(舞蹈类) | 专科批(舞蹈) | 艺术类(平行录取一段)(美术类) | 艺术类(本科)(美术类、音乐类、书法类、航空服务艺术类) | 艺术类(本科)(文学编导类、播音主持类、摄影类) | 艺术类(平行录取二段)(编导类) | 美术类(本科) | 专科批(足球排球篮球类) | 专科批(书法) | 本科二批(足球排球篮球类) | 本科一批(广播电视编导) | 专科批(田径类) | 艺术类(平行录取二段)(影视表演类) | 艺术类(平行录取一段)(时装表演类) | 本科一批(舞蹈) | 本科一批(作曲) | 本科二批(体操武术类) | 本科一批(器乐) | 本科一批(声乐) | 本科一批(书法) | 本科二批(航空服务艺术与管理) | 本科二批(播音与主持艺术) | 本科二批(声乐) | 本科二批(书法) | 艺术类(平行录取一段)(播音主持类) | 广播电视编导类(高职专科) | 专科批(器乐) | 专科批(美术) | 本科一批(田径类) | 艺术类(平行录取二段)(美术类) | 本科一批(航空服务艺术与管理) | 美术类(高职专科) | 音乐类(高职专科) | 舞蹈类(高职专科)
    Data.Year int 录取年份,2014年 - 2025年
    Data.Score int 录取分数线
    Data.SpecialName string 专业说明,如 艺术类(平行录取一段)-音乐类音乐教育声乐主项,如果没有那么值为 null
  • 接口 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/ceeprovince?appkey=APPKEY&keyword=&year=&category='
    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/ceeprovince?appkey=APPKEY&keyword=&year=&category=");
      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/ceeprovince?appkey=APPKEY&keyword=&year=&category=", 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/ceeprovince?appkey=APPKEY&keyword=&year=&category=");
    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/ceeprovince?appkey=APPKEY&keyword=&year=&category="
      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/ceeprovince?appkey=APPKEY&keyword=&year=&category=")
      .method("GET", null)
      .build();
    Response response = client.newCall(request).execute();
    var settings = {
      "url": "https://api.gugudata.com/metadata/ceeprovince?appkey=APPKEY&keyword=&year=&category=",
      "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/ceeprovince?appkey=APPKEY&keyword=&year=&category="]
      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/ceeprovince?appkey=APPKEY&keyword=&year=&category="
    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/ceeprovince?appkey=APPKEY&keyword=&year=&category=")
    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/ceeprovince?appkey=APPKEY&keyword=&year=&category=")!,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/ceeprovince"; // todo: 注意修改请求对应的 API 接口
    // todo: 注意修改构造请求参数
    var data = {
     appkey:'APPKEY', keyword:'', year:, category:''
    };
    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/ceeprovince?appkey=APPKEY&keyword=&year=&category=",
      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元/年
查看详情 数据更新于 3 小时前
30% 折扣
稳定提供服务 10 年 全国大学高校基础信息
  • 提供全国大学高校基础信息
  • 每周定时更新 / 高校各类属性
  • 2999元/年限时折扣 999元/年
查看详情 数据更新于 4 小时前
30% 折扣
稳定提供服务 10 年 全国大学高校专业数据
  • 大学专业多维基础数据
  • 持续更新 / 各类专业属性
  • 2999元/年限时折扣 999元/年
查看详情 数据更新于 6 小时前
30% 折扣
稳定提供服务 10 年 历年高考专业录取分数线
  • 高校专业各省录取分数线
  • 复合查询条件 / 千万级数据
  • 4999元/年限时折扣 2499元/年
查看详情 数据更新于 7 小时前
50% 折扣