• API 功能

    • 通过表单或 JSON 传入高校名称,支持中文或英文名称;
    • 返回学术声誉评分与分析;
    • 提供就业前景维度的评分和说明;
    • 分析学费与奖助体系,补充择校成本视角;
    • 提供学生生活与校园环境评价;
    • 分析学科专业与课程设置;
    • 返回教学质量评分与对应分析;
    • 提供综合评分,便于学校详情页展示评价摘要;
    • 返回推荐理由与适配建议,辅助梳理择校考虑因素;
    • 提供综合总结,可与分项分析一同阅读;
    • 普通模式返回标准 JSON,便于完整读取评分结果;
    • 支持 streaming=true 以 SSE 接收流式输出,适合逐步展示分析;
    • 默认最大 QPS:5,可在开发者中心自助升级,年付订单接口调用次数不限。
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/ai/college-score

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

    请求方式: POST

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY

    数据预览: https://www.gugudata.com/preview/college-score

    接口测试:  https://api.gugudata.com/ai/college-score/demo

    OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

    请求参数(POST 请求参数以 application/x-www-form-urlencoded 格式、文件流以 formdata 格式传递,具体可参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string 是 无 付费后获取的 APPKEY。
    universityName string 是 无 请求体 JSON 字段,需要评分分析的大学名称,可以传中文名、英文名、简称或全称。
    streaming boolean 否 false Query 参数,是否启用流式输出,默认 false;true 时响应为 SSE,false 时返回标准 JSON。

    返回参数

    参数名 参数类型 备注
    DataStatus.RequestParameter string 本次请求的参数摘要字符串。
    DataStatus.StatusCode integer 接口返回状态码。
    DataStatus.StatusDescription string 接口返回状态说明。
    DataStatus.ResponseDateTime string 接口数据返回时间。
    DataStatus.DataTotalCount integer 此条件下的总数据量,一般用于分页计算。
    Data.university string 参与评分的大学名称。
    Data.scores.academic_reputation integer 学术声誉得分。
    Data.scores.employment_prospects integer 就业前景得分。
    Data.scores.tuition_and_scholarships integer 学费与奖助体系得分。
    Data.scores.student_life_and_campus integer 学生生活与校园环境得分。
    Data.scores.programs_and_curriculum integer 学科专业与课程设置得分。
    Data.scores.teaching_quality integer 教学质量得分。
    Data.total_score integer 综合评分,范围 0~100。
    Data.analysis.academic_reputation string 学术声誉维度分析。
    Data.analysis.employment_prospects string 就业前景维度分析。
    Data.analysis.tuition_and_scholarships string 学费与奖助体系维度分析。
    Data.analysis.student_life_and_campus string 学生生活与校园环境维度分析。
    Data.analysis.programs_and_curriculum string 学科专业与课程设置维度分析。
    Data.analysis.teaching_quality string 教学质量维度分析。
    Data.long_recommendation string 院校推荐理由与适配建议。
    Data.long_summary string 综合评价总结。

    响应示例(真实数据节选)

    接口数据预览
    {
      "DataStatus": {
        "RequestParameter": "{\"universityName\":\"北京大学\",\"streaming\":false}",
        "StatusCode": 100,
        "StatusDescription": "高校分析成功",
        "ResponseDateTime": "2026-10-09 08:05:53.891",
        "DataTotalCount": 1
      },
      "Data": {
        "university": "北京大学",
        "scores": {
          "academic_reputation": 20,
          "employment_prospects": 20,
          "tuition_and_scholarships": 14,
          "student_life_and_campus": 15,
          "programs_and_curriculum": 15,
          "teaching_quality": 15
        },
        "total_score": 98,
        "analysis": {
          "academic_reputation": "北京大学作为中国顶尖的高等学府,常年位居国内高校排名前列,并在全球各大权威学术排名中占据重要位置。其在人文社科、理学基础学科等领域拥有世界级的学术声誉,科研实力雄厚,师资力量顶尖,是无数学子心中的学术殿堂,因此获得满分20/20。",
          "employment_prospects": "北大毕业生在就业市场上具有极强的竞争力,深受国内外顶尖企业、政府机构及科研单位的青睐。校友网络强大,遍布政界、商界和学术界,为毕业生提供了广阔的职业发展平台和极高的起点薪资水平,就业前景极佳,得分20/20。",
          "tuition_and_scholarships": "作为公立高校,北大的学费标准符合国家规定,相对合理。学校设有完善的奖助学金体系,包括国家奖学金、校级奖学金及各类社会捐赠基金,覆盖面广,能有效减轻学生经济负担。但由于北京生活成本较高,整体财务压力仍存在,得分14/15。",
          "student_life_and_campus": "北大校园(燕园)历史悠久,环境优美,拥有深厚的文化底蕴和丰富的社团活动。未名湖、博雅塔等标志性景观构成了独特的校园文化氛围。住宿和餐饮条件良好,安全管理严格,为学生提供了优越的学习和生活环境,得分15/15。",
          "programs_and_curriculum": "学科门类齐全,尤其在文、理、医、经管等领域处于领先地位。课程设置注重通识教育与专业教育的结合,鼓励跨学科学习,提供大量选修课和国际交流项目,能够满足不同学生的个性化发展需求,得分15/15。",
          "teaching_quality": "汇聚了众多院士、长江学者等顶级名师,教学水平极高。教学方法注重启发式思维和批判性能力的培养,师生互动频繁,学术氛围浓厚。学生对教学质量的满意度普遍很高,得分15/15。"
        },
        "long_recommendation": "北京大学无疑是中国高等教育的金字塔尖,适合那些学术基础扎实、追求极致卓越、具有强烈求知欲和领导潜力的学生。如果你希望在基础学科领域深耕,或者在人文学科中寻找思想的光芒,北大提供的资源和平台是无与伦比的。这里的竞争虽然激烈,但更能激发人的潜能。选择北大,不仅是选择一所大学,更是选择一种追求卓越的生活方式和一个顶级的精英圈子。建议考生在报考前明确自己的专业兴趣,因为北大的转专业政策相对灵活,但进入热门专业的竞争依然巨大。此外,应充分利用北大的国际交流资源,拓宽全球视野。对于家庭经济条件一般的学生,不必过分担忧,北大的资助体系非常完善,能够确保每一位优秀的学子不因贫困而失学。总之,若能考入北大,将是人生重要的转折点,值得全力以赴。",
        "long_summary": "北京大学作为中国最顶尖的高等学府之一,在学术声誉和就业前景方面均达到了极致水平,分别获得满分20分。其在全球范围内的学术影响力巨大,尤其在人文社科和理学领域享有盛誉,毕业生在就业市场上极具竞争力,校友资源强大。在学费和奖学金方面,虽然学费合理且奖助体系完善,但考虑到北京较高的生活成本,得分为14分。学生生活和校园环境方面,北大拥有深厚的历史底蕴和优美的燕园景色,文化活动丰富,得分15分。学科专业和课程设置全面且灵活,注重跨学科培养,得分15分。教学质量方面,师资阵容豪华,教学理念先进,学生满意度高,得分15分。综合来看,北京大学总分为98分,是追求学术卓越和职业巅峰的学子的理想选择。其强大的品牌效应、丰富的教育资源和广阔的校友网络,为学生的未来发展奠定了坚实基础。尽管入学门槛极高,竞争激烈,但其带来的回报也是巨大的。对于有志于成为行业领袖或学术大师的学生来说,北京大学提供了最好的土壤和舞台。"
      }
    }
  • 鉴权方式

    接口支持以下 AppKey 传递方式,任选一种即可;已有请求示例、Postman 集合和历史代码仍可继续使用原来的 appkey 参数方式。

    传输载体 参数 示例 说明
    HTTP Header X-GUGUDATA-APPKEY X-GUGUDATA-APPKEY: YOUR_APPKEY 推荐方式,适合服务端接入和统一封装。
    HTTP Header X-API-Key X-API-Key: YOUR_APPKEY 通用 API Key Header,便于和常见 API 客户端集成。
    HTTP Header Authorization Authorization: Bearer YOUR_APPKEY 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。
    Query 参数 appkey ?appkey=YOUR_APPKEY 兼容现有示例、Postman 集合、浏览器调试和历史代码。

    部分历史 POST 接口仍兼容表单或 JSON body 中的 appkey;新接入建议优先使用 Header 或 Query 参数。

  • 接口常见 HTTP 响应状态码

    以下为接口调用中常见的 HTTP 传输层状态码,不等同于响应体内的业务状态码;完整状态码注册表以 IANA HTTP Status Code Registry 为准。

    状态码 状态码解释 备注
    200 请求成功 HTTP 请求已成功处理;业务状态请结合响应体中的自定义业务码判断。
    201 资源已创建 创建类接口请求成功,并已生成对应资源。
    202 请求已接受 请求已被接受处理,结果可能异步完成。
    204 无响应内容 请求成功但响应体为空,适用于无需返回数据的操作。
    400 请求参数错误 请求参数缺失、格式错误或参数组合不合法。
    401 认证失败 缺少、无效或未通过认证的访问凭证(如 AppKey)。
    403 无权限访问 订单到期、权限不足或接口额度不可用。
    404 资源不存在 请求路径不存在。
    405 请求方法不允许 当前路径不支持该 HTTP 方法。
    408 请求超时 客户端请求在服务端等待时间内未完成,可稍后重试。
    409 请求冲突 请求与当前资源状态冲突,调整参数或业务状态后重试。
    413 请求内容过大 上传文件或请求体超过接口限制。
    414 请求地址过长 请求 URL 超过服务端可处理长度,建议减少查询参数或改用 POST。
    415 请求内容类型不支持 上传或请求体的内容类型不符合接口要求。
    422 请求语义错误 请求格式正确,但参数取值、语义或业务约束无法处理。
    429 请求频率受限 默认按来源 IP 限速,单 IP 最多 5 QPS,可满足常规业务调用。超出限制时接口会返回 429 请求频率受限;已购买接口订单可加购 10 QPS 扩展。
    431 请求头过大 请求头字段过大或过多,建议精简 Header 后重试。
    500 服务器内部错误 服务端处理异常,请稍后重试。
    502 服务暂时不可用 请稍后重试。
    503 服务暂时不可用 请稍后重试。
    504 请求超时 请稍后重试。
  • 接口自定义业务状态码

    业务状态码 业务状态码解释 备注
    100 成功 HTTP 200
    501 参数错误 HTTP 400
    502 请求频率受限 HTTP 429
    503 订单到期 HTTP 403
    504 APPKEY 缺失或无效 HTTP 401
    505 额度或权限不可用 HTTP 403
    900 内部错误 HTTP 500
    901 高校分析未完成、超时或取消 HTTP 503
  • 请求示例代码

    curl --location --request POST 'https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'universityName=北京大学' \
    --data-urlencode 'streaming=false'
    #include <curl/curl.h>
    
    int main(void) {
      CURL *curl = curl_easy_init();
      if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY");
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/x-www-form-urlencoded");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false");
        CURLcode res = curl_easy_perform(curl);
        (void)res;
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
      }
      return 0;
    }
    
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Net.Http;
    
    var client = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Post, "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY");
    request.Content = new FormUrlEncodedContent(new Dictionary<string, string>
    {
        { "universityName", "北京大学" },
        { "streaming", "false" }
    });
    var response = client.SendAsync(request).Result;
    Console.WriteLine(response.Content.ReadAsStringAsync().Result);
    
    package main
    
    import (
      "strings"
      "fmt"
      "io"
      "net/http"
    )
    
    func main() {
      url := "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY"
      payload := strings.NewReader("universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false")
      req, err := http.NewRequest("POST", url, payload)
      if err != nil {
        fmt.Println(err)
        return
      }
      req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
      res, err := http.DefaultClient.Do(req)
      if err != nil {
        fmt.Println(err)
        return
      }
      defer res.Body.Close()
      body, err := io.ReadAll(res.Body)
      if err != nil {
        fmt.Println(err)
        return
      }
      fmt.Println(string(body))
    }
    
    OkHttpClient client = new OkHttpClient().newBuilder().build();
    MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
    RequestBody body = RequestBody.create(mediaType, "universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false");
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY")
      .method("POST", body)
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
    
    $.ajax({
      url: "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY",
      method: "POST",
      data: { "universityName": "北京大学", "streaming": "false" },
    }).done(function (response) {
      console.log(response);
    });
    
    const https = require("node:https");
    const url = "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY";
    const { URLSearchParams } = require("node:url");
    const body = new URLSearchParams({ "universityName": "北京大学", "streaming": "false" }).toString();
    
    const request = https.request(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/x-www-form-urlencoded",
        "Content-Length": Buffer.byteLength(body)
      }
    }, handleResponse);
    request.on("error", console.error);
    request.write(body);
    request.end();
    
    function handleResponse(response) {
      const chunks = [];
      response.on("data", function (chunk) {
        chunks.push(chunk);
      });
      response.on("end", function () {
        console.log(Buffer.concat(chunks).toString("utf8"));
      });
    }
    
    #import <Foundation/Foundation.h>
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY"]];
    [request setHTTPMethod:@"POST"];
    NSString *body = @"universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false";
    [request setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
    [request setHTTPBody:[body dataUsingEncoding:NSUTF8StringEncoding]];
    NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
        return;
      }
      NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];
    [task resume];
    
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_POSTFIELDS => "universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false",
      CURLOPT_HTTPHEADER => array(
        "Content-Type: application/x-www-form-urlencoded",
      ),
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
    
    import requests
    
    url = "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY"
    payload = { "universityName": "北京大学", "streaming": "false" }
    response = requests.post(url, data=payload)
    print(response.text)
    
    require "uri"
    require "net/http"
    
    url = URI("https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY")
    https = Net::HTTP.new(url.host, url.port)
    https.use_ssl = true
    request = Net::HTTP::Post.new(url)
    request["Content-Type"] = "application/x-www-form-urlencoded"
    request.body = "universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false"
    response = https.request(request)
    puts response.read_body
    
    import Foundation
    
    let semaphore = DispatchSemaphore(value: 0)
    var request = URLRequest(url: URL(string: "https://api.gugudata.com/ai/college-score?appkey=YOUR_APPKEY")!, timeoutInterval: .infinity)
    request.httpMethod = "POST"
    request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
    request.httpBody = "universityName=%e5%8c%97%e4%ba%ac%e5%a4%a7%e5%ad%a6&streaming=false".data(using: .utf8)
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      defer { semaphore.signal() }
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
    }
    task.resume()
    semaphore.wait()
    
  • 常见问题 Q&A

    • Q: 高校名称应该怎么填写?

      A: 在请求体的 universityName 中填写学校名称,一次分析一所高校。支持中文名、英文名或简称;简称有歧义时,建议用学校全称。

    • Q: 怎么展示高校评分和分析?

      A: 用 Data.total_score 展示 0–100 的综合评分,并把各维度的得分和对应 analysis 一起显示。long_recommendation 和 long_summary 则分别用于展示建议和综合总结。

    • Q: 想一次拿到完整报告,还是边生成边展示?

      A: 省略 streaming 或设为 false,直接读取完整 JSON。需要边生成边展示时,在查询参数中传 streaming=true,并按 SSE 事件读取响应。

    • Q: 如何完成第一次 API 调用?

      A: 先确认当前接口的请求方法、必填参数和成功状态,再使用对应产品的 AppKey 发起请求;以实际响应中的业务状态判断结果。 查看接入指南

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

      A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey,并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。

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

      A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入;也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。

    • Q: 请求失败或超时后可以重试吗?

      A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求;超时并不表示服务端未执行,重试前需确认接口是否会重复计费或产生副作用。 查看接入指南

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

      A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发,生产接入前完成联调与容量评估。

    • Q: 数据多久更新?

      A: 不同接口按各自的数据周期更新,请以当前详情页的更新时间、更新频率及字段说明为准;不要将一次请求时间视为数据更新时间。

  • 服务协议与免责声明

    购买或使用 GuGuData API 服务前,请充分阅读服务协议、免责声明与数据合规声明。相关页面均支持在浏览器中快速导出 PDF,便于内部归档、评审和合规留存。

  • 技术支持

    技术支持邮箱:
    support@gugudata.com
    企业微信客服:
    联系客服
  • 专业软件开发与系统工程服务

    GuGuData 官方认证工程合作伙伴,专注企业级数据接口集成、AI 工程化与大规模数据处理。团队深度理解 GuGuData 数据接口体系,具备海量数据采集、治理、检索与高并发接口服务经验,可围绕业务场景构建 AI Agent、MCP 接入、智能工作流和生产级数据应用,让数据能力稳定进入现有流程、内部平台和核心业务系统。

    了解工程服务