高考志愿填报 API

最后更新: 2026-06-22

高考志愿填报 API 让 Agent 用 gaokao_admissions 按分数/位次、科类、选科和批次圈定可报院校专业，自动分冲稳保，带历年录取分与位次、招生计划与选科要求；配套一分一段做分数↔位次换算（先把分数换成位次再择校）。覆盖 31 省 385.8 万条候选，限时免费。

数据覆盖：31 省全量 · 385.8 万条录取候选 · 历年录取分与位次

source	gaokao_admissions
典型 filters	province, track_category, subject_track, batch_code, rank_min, rank_max, is_985, is_211
query	院校名/专业名或意图，如 “计算机与人工智能相关专业”
数据覆盖	31 省全量 · 385.8 万条录取候选 · 历年录取分与位次
适用任务	按位次冲稳保择校、目标院校专业查分、招生计划与选科核对

什么时候用高考志愿填报 API

冲稳保怎么用位次圈定

POST https://api.huohuaapi.com/v1/search
{
  "source": "gaokao_admissions",
  "purpose": "为河南物理类620分考生圈定冲稳保院校专业",
  "filters": {
    "province": "henan",
    "track_category": "general",
    "rank_min": 8000,
    "rank_max": 20000
  },
  "query": "计算机与人工智能相关专业"
}

把这个数据源接入你的 Agent

方式一(推荐):装成 Claude Code / Codex 技能,Agent 需要时自动调用。

curl -fsSL https://skills.huohuaapi.com/gaokao_admissions/install.sh | sh

方式二:直接调 API(token 到控制台开通该数据源)。

curl -s "https://api.huohuaapi.cn/v1/search" \
  -H "Authorization: Bearer $HUOHUA_DATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"gaokao_admissions","query":"...","filters":{}}'

默认入口 https://api.huohuaapi.cn/v1(国内直连),海外或连接失败改用 https://api.huohuaapi.com/v1;功能与计费一致。

收费 · 限时免费:注册获取 API Key 后即可直接调用,无需充值,已含你的 token。Agent 可直接用本页链接安装 skill。

常见问题

高考志愿填报 API 怎么用，要付费吗？

限时免费：注册获取 API Key 后即可直接调用，无需充值；装 skill 或直接 POST /v1/search。

高考多少分能上什么大学、位次能报哪些大学？

把分数或位次传给 gaokao_admissions，按科类、选科、批次圈定可报院校专业并分冲稳保，带历年录取分与位次；先用一分一段把分数换成位次更准。

高考志愿怎么填？

思路是先把分数换成位次（用一分一段），再按位次冲稳保圈定院校专业；gaokao_admissions 直接返回可报清单与历年分位，Agent 据此给填报建议。

有免费的高考志愿填报软件/工具吗？

高考志愿填报 API 限时免费：注册拿 Key 即可调用，可自建志愿填报助手或接入 Agent，无需付费。

filters 和 query 怎么分工？

filters 放确定条件（年份、类型、地区、对象等）；query 放完整自然语言意图，承接难以参数化的语义。

返回结果能直接引用吗？

可以。默认返回带来源的 markdown，适合 Agent 直接引用；需要结构化时请求 return.format=json。

空结果或 invalid_filter 怎么排查？

先放宽 filters、核对字段名与取值，再用更聚焦的 query 重试；仍为空说明该条件下暂无匹配材料。

和模型 API 有什么区别？

模型 API 走 /v1 生成文本；数据 API 走 /v1/search 用 gaokao_admissions 检索可引用材料，二者可在同一 Agent 流程组合。

这个数据 API 有 skill 吗、能直接给 Agent / Claude Code 用吗？

可以。除了直接 POST /v1/search，还提供 skill 包：装进 Claude Code、Codex、Cline 等 Agent 后，Agent 会自动用 gaokao_admissions 检索，无需手写请求。