数据 API
把公开数据接进你自己的系统。按板块订阅，一个板块 999 元 / 年， 结构化字段、分页读取、JSON 与 CSV 两种输出，字段口径与来源一并给。
先说清楚：数据包（Excel 表格 + SQLite 数据库 + PDF 速览）依旧 免费下载，网盘自取；API 是给「要把数据接进自己的系统、不想每周手动下载」的人准备的， 按板块订阅收费。同一份数据，两条通道，内容一致。
定价 单板块 999 元 / 年，多板块按板块叠加
- 该板块下全部数据集，之后新增的也包含
- 全量字段，单次最多 1,000 行，可分页取完
- 每日 2,000 次调用
- JSON / CSV 两种输出，CSV 带 BOM
- 数据源更新后接口同源更新
- 字段含义、来源、质检结论随接口给
板块 一个板块 = 一个领域，价格一致
| 板块 | 代码 | 数据集 | 记录数 | 价格（元/年） | 状态 |
|---|---|---|---|---|---|
| 教育升学 | edu | 35 | 47.7万 | 999 | 可开通 |
| 经济金融 | econ | 4 | 1.8万 | 999 | 可开通 |
| 行业产业 | ind | — | — | 999 | 整理中 |
| 政务民生 | gov | — | — | 999 | 整理中 |
| 交通物流 | tra | — | — | 999 | 整理中 |
| 医药健康 | hea | — | — | 999 | 整理中 |
| 农林牧渔 | agr | — | — | 999 | 整理中 |
| 科技互联 | tec | — | — | 999 | 整理中 |
| 文化体育 | cul | — | — | 999 | 整理中 |
| 环境资源 | env | — | — | 999 | 整理中 |
空壳板块标「整理中」—— 没铺完数据集之前不开通，避免花了钱发现里面什么都没有。 单个数据集不单独卖；只想拿一份的话走免费数据包。
接口 全部走 https://luopan.meiqiuapp.cn/api/v1
| 方法 | 路径 | 密钥 | 说明 |
|---|---|---|---|
| GET | /api/v1/boards | 公开 | 板块清单、价格、每个板块的数据集与记录数 |
| GET | /api/v1/datasets?board=edu | 公开 | 数据集清单，含字段表与来源 |
| GET | /api/v1/datasets/{slug} | 公开 | 单个数据集的元数据（不含数据行） |
| GET | /api/v1/datasets/{slug}/rows | 需要密钥 | 取数：筛选、排序、分页、CSV |
| GET | /api/v1/usage | 需要密钥 | 今日调用量、剩余额度、最近 14 天 |
| POST | /api/v1/apply | 公开 | 申请试用或开通 |
鉴权：Authorization: Bearer lp_xxx（也支持 X-API-Key 与 ?key=）。 密钥不要写进前端代码 —— 它按调用量计费，泄露等于替别人付额度。
查询参数 可叠加，多个条件是「且」
| 参数 | 取值 | 说明 |
|---|---|---|
| limit | 1–1000（默认 100） | 单次返回行数上限 |
| offset | ≥0 | 翻页起点，配合 limit 取完全量 |
| eq.列=值 | 精确匹配 | 如 eq.年份=2026 |
| like.列=值 | 包含匹配 | 如 like.院校名称=清华 |
| gte./lte./gt./lt.列=值 | 数值区间 | 如 gte.min_score=680 |
| q=关键词 | 全字段包含 | 不确定在哪一列时用 |
| sort=列&order=desc | 排序 | asc / desc，数字列按数值排 |
| fields=列,列 | 只返回这几列 | 列多时减小体积 |
| ascii=1 | 字段名换成 ASCII | min_score 而不是「投档最低分」 |
| format=csv | 直接下 CSV | 带 BOM，Excel 打开不乱码 |
列名可以写中文（投档最低分）也可以写 ASCII（min_score），两者等价 —— 对应关系在 /api/v1/datasets/{slug} 返回的 columns 里。
三分钟跑通
# 取数（需密钥）：辽宁投档最低分 ≥ 680，按分数从高到低取 5 条 curl -H "Authorization: Bearer lp_你的密钥" \ "https://luopan.meiqiuapp.cn/api/v1/datasets/edu-gaokao-hebei-2026/rows?gte.min_score=680&sort=min_score&order=desc&limit=5&ascii=1" # 不用密钥也能先看有什么 curl "https://luopan.meiqiuapp.cn/api/v1/boards" curl "https://luopan.meiqiuapp.cn/api/v1/datasets?board=edu"
import requests KEY = "lp_你的密钥" URL = "https://luopan.meiqiuapp.cn/api/v1/datasets/edu-gaokao-hebei-2026/rows" r = requests.get(URL, headers={"Authorization": "Bearer " + KEY}, params={"gte.min_score": 680, "sort": "min_score", "order": "desc", "limit": 100, "ascii": 1}, timeout=20) data = r.json() print(data["total"], "条命中，本次返回", data["count"]) for row in data["data"]: print(row["entity"], row["major"], row["min_score"])
{ "ok": true, "total": 0, // 命中的总条数（用于翻页） "count": 0, // 本次返回多少行 "limit": 5, "offset": 0, "columns": ["entity", "major", "min_score"], "data": [ {} ], "remaining_today": 1999 }
错误码
| HTTP | error | 含义与处理 |
|---|---|---|
| 401 | invalid_key | 密钥无效、被停用或已过期 —— 检查密钥与到期时间 |
| 403 | board_not_subscribed | 这个密钥没订该板块 —— 加板块需单独开通 |
| 429 | quota_exceeded | 当日额度用完，次日 0 点重置；量级大可在申请里提 |
| 429 | rate_limited | 请求太频繁（公开接口按 IP 限速），退避重试 |
| 400 | bad_param | 参数或列名写错，msg 里会说清是哪一列 |
| 404 | not_found / offline | 数据集不存在，或已下架 |
| 503 | no_data_file | 服务端暂时取不到该数据文件（运维问题，稍后重试） |
常见问题
数据包不是免费的吗？为什么 API 收费？
一个板块里有什么？
数据是怎么来的、能不能商用？
密钥怎么拿？多久能用上？
额度怎么算？超了怎么办？
申请试用 / 开通 留个联系方式就行
提交后我们会在 1 个工作日内联系你确认。付款走人工（对公转账 / 收款码）， 确认到账后签发密钥 —— 密钥只在签发时显示一次，请自己存好。